API publique : endpoints, versions et abandon

Endpoints

Aucune clé, rien n’est enregistré. Les réponses et les erreurs sont en JSON ; une erreur a cette forme : {"error": {"code": "...", "message": "...", "hint": "..."}}. La description complète est dans /openapi.json.

Parcourir les résultats

/api/v1/docs/ répond avec au plus limit résultats et un next_cursor. Pour la suite, renvoyez la même requête avec cursor égal à cette valeur. Quand il n’y a plus rien, next_cursor vaut null. Un curseur ne marche qu’avec le même q et le même locale. Traitez-le comme une chaîne opaque.

Versions

• La version est dans le chemin : /api/v1/. La v1 est la version actuelle et la seule.
• Dans la v1 on ne fait qu’ajouter : nouveaux champs, nouveaux endpoints, nouveaux paramètres facultatifs. Votre code doit ignorer les champs qu’il ne connaît pas.
• Un changement qui peut casser un client qui marche, comme supprimer ou renommer un champ, changer son type ou son sens, ou supprimer un endpoint, ne sort que sous un nouveau chemin comme /api/v2/.
• Cette politique couvre /api/v1/ et /ask. Le serveur MCP est décrit sur Serveur MCP.

Politique d’abandon

• Quand une nouvelle version sort, l’ancienne marche encore au moins 6 mois.
• Pendant ces mois, chaque réponse de l’ancienne version porte un en-tête Deprecation (RFC 9745), un en-tête Sunset (RFC 8594) avec la date d’arrêt, et un Link vers la nouvelle version.
• Le changement et ses dates sont aussi listés plus bas, dans Changements de l’API.
• Aujourd’hui rien n’est abandonné, donc aucune réponse ne porte ces deux en-têtes. Chaque réponse renvoie ici avec Link: <https://multiplegroupposter.com/docs/api/>; rel="deprecation".

Changements de l’API