Démarrer

Changelog

Changements matériels de l'API publique Alloovium. Les changements additifs arrivent sans changement de version — les changements cassants ne le font jamais. Tout ce qui déplacerait un champ, supprimerait un endpoint ou changerait un code d'erreur obtient sa propre version majeure.

Politique de versionnage

L'API est versionnée dans le chemin URL (path). Nous ne supprimerons pas de champs, ne renommerons pas d'endpoints ni ne changerons les formes de réponse à l'intérieur d'une version majeure. Les nouveaux champs, nouveaux endpoints et nouveaux paramètres optionnels sont additifs et arrivent sans avertissement. Si vous utilisez un SDK généré, régénérez-le après chaque release pour récupérer les ajouts.

2026-04-08 — sortie publique v2

Première version publique de la surface API v2 et du serveur FastMCP 3.x construit par-dessus.

count capabilities montées sur vault, chat, workflows, templates et meta.
Authentification par clé API avec préfixes live / test, schéma Bearer, rotatif sans redémarrage.
Stack OAuth 2.1 : PKCE (S256), Dynamic Client Registration (RFC 7591), Protected Resource Metadata (RFC 9728), métadonnées du serveur d'autorisation (RFC 8414), révocation de token (RFC 7009). Capabilities en lecture seule uniquement.
Enveloppe d'erreur RFC 7807 problem-details sur chaque 4xx/5xx — voir Erreurs.
Clés d'idempotence sur chaque endpoint d'écriture, cache de 24 heures, verrou en cours de 60 secondes — voir Idempotence.
Endpoints de liste paginés par curseur avec une enveloppe envelope stable — voir Pagination.
Limites de débit appliquées par niveau (free / standard / pro / enterprise) via un token bucket — voir Limites de débit.
Serveur MCP Streamable HTTP sur path exposant toutes les capabilities non-multipart — voir Serveur MCP.
Référence OpenAPI interactive sur path propulsée par Scalar.

Lacunes connues

capability est un stub et retourne actuellement code. Quand il arrivera, il reflétera le protocole d'événements SSE v1 (delta, progress, citation, done).
La livraison de webhook pour les jobs asynchrones (ingestion de document, exécutions de workflow, remplissages de template) n'est pas encore exposée publiquement. Interrogez l'endpoint endpoint correspondant en attendant.
OAuth est en lecture seule. Les capabilities d'écriture requièrent une clé API parce que leurs handlers ont besoin du principal ORM complet — appeler l'une avec un Bearer JWT OAuth retourne code.

Politique de dépréciation

Quand quelque chose doit partir, nous l'annoncerons ici avec au moins 90 jours de préavis avant tout changement de comportement. Les endpoints dépréciés continuent de fonctionner pendant toute la période de préavis ; ils gagnent simplement un header dep et sunset pour que votre stack d'observabilité puisse vous alerter.

La surface v1 sous path est l'API interne de l'application et ne fait pas partie du contrat public — ne construisez pas dessus. Utilisez v2 exclusivement depuis du code tiers.

Voir aussi

Référence API — la référence Scalar interactive, toujours synchronisée avec l'API en cours d'exécution.
Capabilities — parcourez le catalogue d'endpoints complet.