REST

http://media.formandome.es/markdownslides/api-rest/export/api-rest-reveal-slides.html

• La arquitectura REST se ha impuesto para construir web services.
  • Significado: REpresentational State Transfer.
  • Los recursos se representan por nombres en plural.
  • Las rutas tienen un sentido semántico.
  • Las acciones se basan en los verbos http: GET, POST, PUT, DELETE.
  • El resultado se refleja en los códigos http: 200 OK, 404 Not found, ...
• El conjunto de servicios ofrecidos por un servicio web constituye un API (Application Programming Interface)
• Un api que sigue los principios REST (nombre) es un API restful(adjetivo).

  Rutas y verbos

• Los recursos siempre en plural.
• El verbo HTML usado es determinante para saber que queremos hacer:
  • Lista: GET http://eventos.com/api/eventos/
  • Detalle de un elemento: GET http://eventos.com/api/eventos/2
  • Alta de elemento: POST http://eventos.com/api/eventos/
  • Modificar elemento: PUT http://eventos.com/api/eventos/2
  • Borrar elemento: DELETE http://eventos.com/api/eventos/2

• Las rutas puedes ser más elaboradas:

  • Lista de comentarios de un evento: GET http://eventos.com/api/eventos/3/comentarios
  • Añadir comentario al evento: POST http://eventos.com/api/eventos/3/comentarios

  Respuestas

• Errores:

  • 403: Acceso prohibido
  • 404: No encontrado.
  • 500: Error en el servidor

• Mensajes de éxito:

  • GET: 200
  • POST: 201. Creado con éxito.
  • DELETE: 200. OK
  • PUT: 200, modificado correctamente. 201, objeto creado con éxito.