El Protocolo HTTP

Para entender cómo consumir y producir interfaces de programación de aplicaciones, es necesario comprender que la base de una API está en el conocimiento del protocolo HTTP. Si se entiende el protocolo, para consumir una API solo resta emplear una biblioteca que permita realizar solicitudes HTTP, y para producirla, bastará con crear recursos que en vez de vistas, retornen datos, y que por otra parte, constaten que la solicitud HTTP haya sido correcta.

El protocolo HTTP está basado en una arquitectura cliente-servidor. Esta arquitectura plantea dos componentes (programas) conectados sobre una red informática:

• un cliente que consume los recursos provistos por un servidor;
• y un servidor, que provee de recursos a los clientes.

Los clientes solicitan al servidor un recurso, el servidor acepta la solicitud, y retorna al cliente los resultados de la ejecución.

Los recursos provistos por el servidor (funcionalidades que el servidor puede llevar a cabo), son ofrecidos mediante un identificador uniforme de recurso (URI), también conocido como localizador uniforme de recursos (URL).

En lo que a HTTP concierne, los identificadores uniformes de recursos, es decir, los URI o URL, son cadenas de texto simple que permiten identificar mediante un nombre o localización, un recurso específico (lo que a los ojos del software, sería una funcionalidad concreta o un paso en una funcionalidad).

Un URI HTTP puede indicarse en uno de dos formatos: absoluto o relativo. Es absoluto cuando incluye el esquema “http” seguido de dos puntos, y es relativo cuando provee el nombre del recurso sobre una base conocida (host). El esquema “http” se utiliza para localizar recursos bajo el protocolo homónimo (HTTP) empleando el siguiente formato:

http://<host>[:<puerto>][<ruta absoluta del recurso>][?<cadena de consulta>]

Un ejemplo completo podría verse como el siguiente:

http://www.elidabahit.co.uk:8080/ruta/absoluta?consulta=una+cadena+cualquiera

Cuando el puerto no es indicado en el URI, por defecto, el protocolo entiende que el acceso será a través del puerto 80.

Las solicitudes HTTP se envían en una sola línea sin saltos (excepto al final). Una solicitud HTTP presenta el siguiente formato:

<método><SP><URI><SP><HTTP-Version><CRLF>

En la línea anterior, <SP> significa espacio en blanco y <CRLF>, salto de línea.

Estas solicitudes HTTP se envían empleando un método específico. El protocolo HTTP ofrece diferentes métodos de solicitud. Actualmente, la versión HTTP/1.1 define ocho métodos. Las denominaciones así como su descripción, se presentan en la siguiente tabla:

Otros dos métodos son TRACE y CONNECT definidos en las secciones 9.8 y 9.9 de las RFC 2616, respectivamente.

Tras recibir la solicitud, y dependiendo tanto del método empleado por el cliente para efectuar la solicitud, como del resultado obtenido por el servidor al llevarla a cabo, este responderá al cliente con un mensaje compuesto de una línea de estado.

La línea de estado estará formada por la versión del protocolo, un código de estado de 3 dígitos, y su correspondiente explicación en una cadena de texto.

Existen cinco clases de respuesta que pueden ser identificadas por el primer número del código de estado. Las clases de respuesta se describen en la siguiente tabla:

Las secciones 10.1 a 10.5 de las RFC 2616, definen la lista completa de los códigos de estado para las cinco clases de respuesta. Algunos de estos estados se describen en la siguiente tabla: