Buenas prácticas para diseñar APIs RESTful

Clase 19 de 19 • Curso de API REST con PHP

Clase anteriorSiguiente clase

Resumen

Felicitaciones has llegado al final del curso, ahora conoces todos los tecnicismos para generar una API RESTful. Recuerda seguir las buenas prácticas:

  1. Siempre utiliza sustantivos para nombrar tus recursos.
  2. Añade los nombres en plural para las urls.
  3. Las modificaciones a recursos deben hacerse con su verbo HTTP correspondiente: POST, PUT o DELETE.
  4. Para devolver recursos asociados a otro recurso utiliza url que incorporen subrecursos: /Autos/1/Choferes.
  5. Navegabilidad vía vínculos.
  6. Cuando devuelvas colecciones deben ser filtrables, ordenables y paginables.
  7. Versiona tu API, añade el número de versión en la url: v1/Autos.

No olvides tomar el examen para evaluar tus conocimientos y dejar una review del curso.