Versionierung und Einstellung der Fluos-API
Fluos versioniert seine öffentliche HTTP-API unter /api/v1/ und mit dem Header API-Version. Veraltete Versionen senden die Header Sunset und Deprecation.
Agenten sollten ihre Integrationen auf eine Version der Fluos-API festlegen. Fluos ändert eine veröffentlichte Version nicht stillschweigend.
Wie Fluos die API versioniert
- URL-Pfad (kanonisch):
/api/v1/…— zum Beispiel/api/v1/search,/api/v1/openapi.json,/api/v1/mcp. - Versions-Header: sende
API-Version: 1. Die Antworten gebenAPI-Version: 1zurück. - Aliase ohne Version wie
/api/searchund/openapi.jsonentsprechen v1.
Inkompatible Änderungen erscheinen unter /api/v2/, nie als Änderung an v1. Das OpenAPI-Feld info.version folgt derselben Hauptversion (1.0.0).
curl -sI -H 'API-Version: 1' https://www.fluos.io/api/v1/search?query=authenticationRichtlinie zur Einstellung
Wenn Fluos eine Version oder eine Operation abschaltet:
| Header | Spezifikation | Bedeutung |
|---|---|---|
Deprecation: true | RFC 9745 | Diese Version oder Operation ist veraltet |
Sunset: <HTTP-date> | RFC 8594 | Frühestes Datum, an dem die Version entfernt werden darf |
Link | RFC 8288 | rel="deprecation" verweist auf diese Seite; rel="successor-version" verweist auf den Nachfolger |
Fluos kündigt das Entfernen einer veralteten öffentlichen Version mindestens 180 Tage vorher mit Sunset an. v1 ist die aktuelle Version und hat kein Sunset-Datum.
Ratenbegrenzungen
Die öffentlichen Discovery-Endpunkte (Suche, MCP, Markdown-/JSON-Aushandlung) liefern bei jeder Antwort die IETF-Header RateLimit / RateLimit-Policy sowie RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset. Eine 429-Antwort enthält Retry-After. Siehe die Fluos-API-Referenz.