Convención de API REST

[edittler]

Hay 2 sitios que para mi son de referencia en cuanto a información sobre APIs REST.

Lo ideal es que sigamos las convenciones y evitar reinventar la rueda.

• REST API Tutorial: Todo lo relacionado al uso de verbos HTTP, forma de nombrar los recursos, códigos de respuesta.
• JSON API: Convención de la estructura de los JSONs de APIs.

Por último, algo que no está tan documentado o no hay convención clara es el versionado de API. Pero hay una respuesta en Stackoverflow donde da una idea al respecto.
La idea es que en este proyecto la URL base sea de la forma api/<version> donde <version> puede ser v1, v2, etc.

[colltoaction]

No dejen de mirar si vale la pena http://graphql.org/. Es la nueva moda 😎.

[edittler]

Seeeeeee! Justamente el otro día consulté sobre GraphQL para saber qué tanto se usa. Tengo ganas de jugar un poco con eso, pero sería después de que implemente algo básico con el clásico REST o si la gente de front le piensa dar uso.