REST Api print file design

Question

Je suis en train de concevoir une API REST pour un logiciel de test et j'ai un doute. J'ai beaucoup cherché mais ce n'est pas assez clair pour moi. Mon scénario est une file d'attente contenant plusieurs tâches à imprimer. Ces tâches sont des objets complexes et le flux de travail d'impression est une autre action complexe. Je ne sais pas quelle opération correspond le mieux à cela. Selon ce, il devrait être un POST?

http://restful-api-design.readthedocs.org/en/latest/methods.html

Dans ce cas, mon action s'adaptera mieux dans un modèle RPC, mais nous devons utiliser REST selon que 95% des actions correspond parfaitement à ce modèle.

Dans le cas d'un POST, je dois envoyer la file d'attente que je veux imprimer dans le corps?

Merci beaucoup.

Answer 1

Je ne sais pas ce que vous voulez exposer à travers votre API REST mais j'y penserais.

Vous pouvez exposer une ressource avec le chemin /printjobs correspondant à la file d'attente d'impression. L'utilisation d'une méthode POST ajouterait un travail dans la file d'attente. Le code d'état renvoyé serait 202 Accepted car il s'agit d'un élément asynchrone et renvoie un identifiant pour le nouveau travail. Quelque chose en arrière-plan serait responsable de gérer le travail dans la file d'attente. Je pense que c'est quelque chose de différent de l'API REST.

Ensuite, vous pouvez utiliser une ressource /printjobs/{id} qui vous donnera des conseils sur l'état de la tâche (méthode GET), supprimer (méthode DELETE) et mettre à jour son statut (par exemple pour le suspendre avec la méthode PUT ou PATCH)/

espérons qu'il vous aidera, Thierry