Quelle est la meilleure pratique pour les urls reposantes?

Question

J'ai un serveur de repos basé sur Java, et mes clients utiliseront principalement Ruby.

Quelle est la meilleure pratique pour la structure d'URL?

Ceci est uniquement pour JSON.

Dites ceci est une application de blog:

par exemple:

Obtenir tous les messages:

GET http://www.example.com/api/v1/posts.json 

Supprimer le post avec id 1:

DELETE http://www.example.com/api/v1/posts/1.json 

Qu'en est-il des collections embarquées comme :

Obtenez tous les commentaires pour le post 1:

GET http://www.example.com/api/v1/posts/1/comments.json 

Voir l'article 1 de commentaire avec id 1:

GET http://www.example.com/api/v1/posts/1/comments/1.json 

Y at-il un document qui va sur cela quelque part? Quelque chose de "officiel"?

Answer 1

Apigee a un livre électronique gratuit sur la conception de l'API RESTful. Vous devez fournir une adresse e-mail pour l'obtenir:

http://offers.apigee.com/api-design-ebook-rr/

Vous allez trouver cela est une question d'opinion, sans spécification officielle, mais vos URL me semblent bonnes, et serait conformément aux lignes directrices de ce livre. L'exception possible étant la dernière. Si 1 est l'identifiant unique d'un commentaire,/posts/1/peut ne pas être nécessaire.

Answer 2

Vous pouvez commencer par le papier qui a inventé REST et regardez la section URI: http://www.ics.uci.edu/~fielding/pubs/dissertation/evaluation.htm#sec_6_2

Bob Aman de bien considéré 2ème réponse à cette question SO donne des indications détaillées: How to create REST URLs without verbs?

Answer 3

correctement en utilisant la Le protocole HTTP est la meilleure idée. Lire quelques-uns sur le versionnage de l'URL. http://blog.steveklabnik.com/posts/2011-07-03-nobody-understands-rest-or-http