Versionado y obsolescencia de la API de Fluos
Fluos gestiona su API HTTP pública bajo /api/v1/ y con el encabezado API-Version. Las versiones obsoletas envían los encabezados Sunset y Deprecation.
Los agentes deben fijar las integraciones a una versión de la API de Fluos. Fluos no cambiará silenciosamente una versión publicada.
Cómo Fluos versiona la API
- Ruta URL (canónica):
/api/v1/…— por ejemplo/api/v1/search,/api/v1/openapi.json,/api/v1/mcp. - Encabezado de versión: envía
API-Version: 1. Las respuestas devuelvenAPI-Version: 1. - Los alias sin versión como
/api/searchy/openapi.jsonson equivalentes a v1.
Los cambios rotativos se publican como /api/v2/, no como un cambio en v1. El campo OpenAPI info.version rastrea la misma versión mayor (1.0.0).
curl -sI -H 'API-Version: 1' https://www.fluos.io/api/v1/search?query=webhooksPolítica de obsolescencia
Cuando Fluos retira una versión o una operación:
| Cabecera | Especificación | Significado |
|---|---|---|
Deprecation: true | RFC 9745 | Esta versión u operación está obsoleta |
Sunset: <HTTP-date> | RFC 8594 | Fecha más temprana para eliminar la versión |
Link | RFC 8288 | rel="deprecation" apunta a esta página; rel="successor-version" apunta al reemplazo |
Fluos te da al menos 180 días de aviso de Sunset antes de eliminar una versión pública obsoleta. La v1 es la actual y no tiene fecha de retirada.
Límites de tasa
Los puntos finales públicos de descubrimiento (búsqueda, MCP, negociación markdown/JSON) devuelven los encabezados IETF RateLimit / RateLimit-Policy en cada respuesta, además de RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset. Un 429 incluye Retry-After. Consulta la referencia de la API Fluos.