Versionnage et dépréciation de l’API Fluos
Fluos versionne son API HTTP publique sous /api/v1/ et avec l’en-tête API-Version. Les versions dépréciées envoient les en-têtes Sunset et Deprecation.
Les agents doivent figer leurs intégrations sur une version de l’API Fluos. Fluos ne modifiera pas discrètement une version publiée.
Comment Fluos versionne l’API
- Chemin d’URL (canonique) :
/api/v1/…— par exemple/api/v1/search,/api/v1/openapi.json,/api/v1/mcp. - En-tête de version : envoyez
API-Version: 1. Les réponses renvoientAPI-Version: 1. - Alias sans version tels que
/api/searchet/openapi.json: équivalents à la v1.
Les changements incompatibles sont publiés sous /api/v2/, jamais comme une modification de la v1. Le champ OpenAPI info.version suit la même version majeure (1.0.0).
curl -sI -H 'API-Version: 1' https://www.fluos.io/api/v1/search?query=authenticationPolitique de dépréciation
Lorsque Fluos retire une version ou une opération :
| En-tête | Spécification | Signification |
|---|---|---|
Deprecation: true | RFC 9745 | Cette version ou cette opération est dépréciée |
Sunset: <HTTP-date> | RFC 8594 | Date la plus proche à laquelle la version peut être supprimée |
Link | RFC 8288 | rel="deprecation" renvoie vers cette page ; rel="successor-version" renvoie vers le remplaçant |
Fluos donne au moins 180 jours de préavis Sunset avant de supprimer une version publique dépréciée. La v1 est la version actuelle et n’a pas de date de fin.
Limites de débit
Les points d’accès publics de découverte (recherche, MCP, négociation markdown/JSON) renvoient les en-têtes IETF RateLimit / RateLimit-Policy à chaque réponse, ainsi que RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset. Une réponse 429 inclut Retry-After. Consultez la référence de l’API Fluos.