Orders

REST APIs utilizan Uniform Resource Identifiers (URI) para direccionar los recursos. Los diseños de URIs bien hechos comunicarían claramente el recurso de la API

Red externa

• URI Scheme: El esquema identifica el protocolo de acceso a los recursos, puede ser HTTP (without SSL) or HTTPS (with SSL). Se compone del nombre del esquema seguido de dos puntos (“:”).

• Authority: Es el elemento jerárquico que identifica la autoridad de nomenclatura, está formado por el nombre de host y el puerto.

• Hostname: Es el identificador de una máquina dentro de una red que identifica el host que contiene el recurso.

• Port: Es un valor opcional que especifica el puerto en el que el host escucha las peticiones, el puerto por defecto de un servidor web es el 80.

• Path: Es la ruta que identifica el recurso específico en el host al que el cliente consumidor quiere acceder, separando la estructura jerárquica de los recursos con una barra (“/”).

• Section: En la jerarquía lógica de los recursos, éste sería el recurso padre.

• Sub-section: Es un hijo de recurso, directamente relacionado con un recurso paterno.

• Query: Es un componente opcional que se incluye después de la ruta de acceso y tiene una estructura no jerárquica, y proporciona una cadena de información que el recurso puede utilizar para algún propósito, por ejemplo, para buscar parámetros o datos a procesar. La consulta suele ser una cadena de pares de parámetros y valores ("argumento=valor"). Los argumentos junto con los valores se separan entre sí con un ampersand ("&").

• Arguments: Son los parámetros que se utilizarán en la consulta, deben ir inmediatamente después de la ruta y comenzar con un signo de interrogación ("?").

• Values: Son los valores que contienen los parámetros de la consulta.

• Fragment: El fragmento es un componente opcional que permite identificar una parte del recurso principal, o la vista de una representación del mismo. El comienzo de este componente se indica con el carácter de libra ("#").