Es importante entender que el WS es, en el fondo, una especificación para crear y obtener recursos. Un recurso se identifica con una URI (uniform resource identifier).
La totalidad de los recursos del WS están envueltos en una estructura JSON. Es decir, una imagen o un pdf primero es traducido a base64 y es devuelto como valor de una clave en la estructura JSON del response.
La creación de los recursos se realiza mediante un request con el método POST.
La obtención de recursos se hace mediante un request con el método GET a la URI. En los capítulos siguientes se elaboran detalladamente estos conceptos.
La URI del recurso es la forma de accederlo como ya lo dijimos. Está conformada por la URL BASEo dirección del WS + el nombre del recurso + su token. Supongamos que en la página de suap de testing vemos la orden número 654321. Su tokenes O654321 (regla para órdenes). La URIpara acceder esa orden mediante el WS es entonces:
Los recursos, en su mayoría, contienen atributos. Los nombres de los atributos pueden ser un grupo de palabras. Por ejemplo la fecha de realización de una orden es “FechaRealizacion”. Las palabras que componen el nombre de los atributos van capitalizadas y pegadas sin ningún carácter en general. Eventualmente podrían separarse por un guión bajo.
FALTA DOCUMENTAR