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

PD: si hablo rápido me detienen D:

¿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.
  • GET /users     -> Lista los usuarios
  •  
  • POST /users   -> Crea un usuario
  • PUT /users/123   -> Edita al usuario
  • DELETE /users/123  -> Elimina el usuario
  • PATCH /users/123     -> Modificar cierta información del usuario

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

Postman

https://www.getpostman.com/

Made with Slides.com