Salutations,
j'espère que la formulation de ma question sera claire: j'ai un jeu web, sur un serveur. Donc, je peux contacter le serveur avec des URLs, et pour chaque URL, donner d'éventuels paramètres GET ou POST, avec également un verbe HTTP et éventuellement des formats de retours possibles (des HTTP Accept valides).
Donc, un genre de REST généralisé.
Quel format standard me permettrait de déclarer la liste de ces URLs avec, pour chacune, les verbes HTTP acceptés, et les paramètres GET/POST/HTTP Accept correspondant, ainsi que la description du endpont?
Donc, en gros, quel format standard utiliser pour documenter un serveur REST?
La doc d'OVH par exemple est bien foutu dans le style https://api.ovh.com/console/
Est-ce qu'il existe un outil général pour faire ce genre de présentation, et si oui, quel format prend-il en entrée?
j'espère que la formulation de ma question sera claire: j'ai un jeu web, sur un serveur. Donc, je peux contacter le serveur avec des URLs, et pour chaque URL, donner d'éventuels paramètres GET ou POST, avec également un verbe HTTP et éventuellement des formats de retours possibles (des HTTP Accept valides).
Donc, un genre de REST généralisé.
Quel format standard me permettrait de déclarer la liste de ces URLs avec, pour chacune, les verbes HTTP acceptés, et les paramètres GET/POST/HTTP Accept correspondant, ainsi que la description du endpont?
Donc, en gros, quel format standard utiliser pour documenter un serveur REST?
La doc d'OVH par exemple est bien foutu dans le style https://api.ovh.com/console/
Est-ce qu'il existe un outil général pour faire ce genre de présentation, et si oui, quel format prend-il en entrée?
