Versionamento e deprecazione dell’API di Fluos
Fluos versiona la sua API HTTP pubblica sotto /api/v1/ e con l’header API-Version. Le versioni deprecate inviano gli header Sunset e Deprecation.
Gli agenti dovrebbero fissare le proprie integrazioni a una versione dell’API di Fluos. Fluos non modificherà in silenzio una versione pubblicata.
Come Fluos versiona l’API
- Percorso URL (canonico):
/api/v1/…— per esempio/api/v1/search,/api/v1/openapi.json,/api/v1/mcp. - Header di versione: invia
API-Version: 1. Le risposte restituisconoAPI-Version: 1. - Alias senza versione come
/api/searche/openapi.json: equivalgono alla v1.
Le modifiche incompatibili vengono pubblicate sotto /api/v2/, mai come modifica della v1. Il campo OpenAPI info.version segue la stessa versione major (1.0.0).
curl -sI -H 'API-Version: 1' https://www.fluos.io/api/v1/search?query=authenticationPolitica di deprecazione
Quando Fluos ritira una versione o un’operazione:
| Header | Specifica | Significato |
|---|---|---|
Deprecation: true | RFC 9745 | Questa versione o operazione è deprecata |
Sunset: <HTTP-date> | RFC 8594 | Data più vicina in cui la versione può essere rimossa |
Link | RFC 8288 | rel="deprecation" rimanda a questa pagina; rel="successor-version" rimanda alla versione sostitutiva |
Fluos dà almeno 180 giorni di preavviso Sunset prima di rimuovere una versione pubblica deprecata. La v1 è quella attuale e non ha una data di dismissione.
Limiti di frequenza
Gli endpoint pubblici di discovery (ricerca, MCP, negoziazione markdown/JSON) restituiscono gli header IETF RateLimit / RateLimit-Policy a ogni risposta, oltre a RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. Una risposta 429 include Retry-After. Vedi il riferimento dell’API di Fluos.