Gestion des versions
Il n'existe pas d'en-tête de version d'API. Ce que signifient les deux chemins MCP, ce qui est stable, et ce qui se passera le jour où un élément sera déclaré obsolète.
Cette page répond sans détour à une seule question : que puis-je figer dans mon intégration ?
Il n'existe pas d'en-tête de version d'API
La plateforme n'en lit aucun. N'en envoyez pas, et ne construisez rien autour. Un en-tête ignoré est pire que pas d'en-tête du tout : il donne l'impression qu'une intégration est figée sur une version alors qu'elle ne l'est pas.
L'endpoint MCP a deux chemins
| Chemin | Usage |
|---|---|
/api/mcp/<storeId> | L'original. Conservé sans limite de durée, car les clients installés l'ont dans leur configuration |
/api/mcp/v1/<storeId> | Les nouvelles connexions |
Il s'agit d'un seul endpoint sous deux noms. Mêmes handlers, et un token émis par l'un fonctionne sur l'autre. L'alias versionné tient en 21 lignes qui réexportent les mêmes handlers.
Rien n'a encore été déclaré obsolète
Il n'y a donc aucune durée de maintien à citer, et en citer une reviendrait à décrire une politique qui ne s'est jamais appliquée à rien.
La page que celle-ci remplace promettait que « les versions précédentes restent en ligne 24 mois », à côté d'un en-tête de version qui n'existait pas. Les deux étaient inventés.
Le jour où un élément sera déclaré obsolète, l'annonce sera publiée avant le changement et non après, dans les nouveautés et sur cette page.
Ce sur quoi vous pouvez compter aujourd'hui
- Les noms d'outils du catalogue MCP. Ajouter un outil ne casse rien ; en renommer un reviendrait à déclarer l'ancien nom obsolète, et ce serait annoncé.
- Les chaînes de scope comme
boostecom:catalog.read. Une autorisation accordée garde le sens qu'elle avait au moment du consentement. - Le format des clés Intelligence
bei_et leur contrat en lecture seule. - Les schémas de signature des webhooks, propres à chaque fournisseur.
Ce sur quoi vous ne devez pas compter
- La forme d'un champ JSON non documenté. S'il ne figure pas dans cette documentation, il peut changer.
- Les plafonds de limitation de débit, comme s'ils étaient contractuels. Ils sont opérationnels, et Erreurs et limites de débit explique quoi faire quand vous en atteignez un.
- Tout ce qu'une ancienne page marketing affirmait sur les versions. C'est cette page-ci qui est vérifiée.