Comment on page
Nommage
- kebab-case pour les URLs.
- under_score ou camelCase pour les paramètres en “query string” et pour les “fields” des ressources.
- kebab-case pluriel pour les noms des ressources dans les URLs.
Utilisez des noms explicites respectant la métaphore (ou ubiquitous language) du service.
Les URLs doivent être construites de la façon suivante :
/resources
/blogs
/resources/:resourceId
/blogs/:blogId
/resources/:resourceId/subresources
/blogs/:blogId/posts
Evitez donc les URLs de type :
/blogs/:blogId/summary
Ce n’est pas du ReSTafaring. De nombreuses librairies sont conçues ainsi. Contourner ces règles vous obligera à modifier, détourner et torturer les librairies et frameworks que vous utilisez.
Dernière mise à jour 3yr ago