API Rest y Postman

Sobre mi...

• César Encina León
• Ingeniero en Informática (INACAP)
• Desarrollador FullStack en Autofact (Santiago)

Me encanta programar <3

@dmaster69

/DMaster69

¿Que es Rest?

• “Representational State Transfer”, es un tipo de arquitectura de desarrollo web que se apoya totalmente en el estándar HTTP.
• REST nos permite crear servicios y aplicaciones que pueden ser usadas por cualquier dispositivo o cliente que entienda HTTP, por lo que es increíblemente más simple y convencional que otras alternativas que se han usado en los últimos diez años como SOAP y XML-RPC.
• Podríamos considerar REST como un framework para construir aplicaciones web respetando HTTP.

Principio Restful

• RESTFul es la implementación de la arquitectura REST en servicios orientados a web.

• Principios estrictos:

  • Uso Correcto de URI’s

  • Uso explicito de verbos HTTP (GET, POST, PUT, DELETE, PATCH)  y códigos de estado

  • Nunca debe mantener algún estado en el servidor.

  • Debe responder tipos de medios de internet (Hipermedia – XML, JSON o ambos)

Uso correcto de URI's

• Las acciones directas sobre una ruta web , deben ser eliminada.
• Ejemplo:  
  • POST http://piik.in/v1/user/172522ec1028ab7/edit
  • PUT   http://piik.in/v1/user/172522ec1028ab7
• Definición de URI en base a recursos (todo es un recurso), usuarios, roles, etc.
• Las URIs no deben implicar acciones y deben ser únicas
• Las URIs deben ser independientes de formato (el formato se define por content-type)

Uso explicito de verbos

Para la manipulación de los recursos:

• GET: Para consultar y leer recursos
• POST: Para crear recursos
• PUT: Para editar recursos
• DELETE: Para eliminar recursos.
• PATCH: Para editar partes concretas de un recurso.

Uso de Códigos de Estado

No mantiene estado

Una aplicación o cliente de servicio web REST debe incluir dentro del encabezado y del cuerpo HTTP de la petición todos los parámetros, contexto y datos que necesita el servidor para generar la respuesta. 

En Resumen: Se debe Eliminar TODO componente de sesión o almacenamiento de variables especificas de usuario o de contexto en el lado del servidor o API!.

Responde en distintos formatos

La última restricción al momento de diseñar un servicio web REST tiene que ver con el formato de los datos que la aplicación y el servicio intercambian en las peticiones/respuestas.

• application/json

• application/xml

• application/html+xml