Versionamento e descontinuação da API do Fluos
O Fluos versiona sua API HTTP pública em /api/v1/ e com o cabeçalho API-Version. Versões descontinuadas enviam os cabeçalhos Sunset e Deprecation.
Agentes devem fixar suas integrações em uma versão da API do Fluos. O Fluos não altera silenciosamente uma versão publicada.
Como o Fluos versiona a API
- Caminho da URL (canônico):
/api/v1/…— por exemplo/api/v1/search,/api/v1/openapi.json,/api/v1/mcp. - Cabeçalho de versão: envie
API-Version: 1. As respostas devolvemAPI-Version: 1. - Aliases sem versão, como
/api/searche/openapi.json, equivalem à v1.
Mudanças incompatíveis são publicadas como /api/v2/, não como alteração da v1. O campo info.version do OpenAPI acompanha a mesma versão principal (1.0.0).
curl -sI -H 'API-Version: 1' https://www.fluos.io/api/v1/search?query=authenticationPolítica de descontinuação
Quando o Fluos aposenta uma versão ou uma operação:
| Cabeçalho | Especificação | Significado |
|---|---|---|
Deprecation: true | RFC 9745 | Esta versão ou operação está descontinuada |
Sunset: <HTTP-date> | RFC 8594 | Data mais próxima em que a versão pode ser removida |
Link | RFC 8288 | rel="deprecation" aponta para esta página; rel="successor-version" aponta para a substituta |
O Fluos dá no mínimo 180 dias de aviso por Sunset antes de remover uma versão pública descontinuada. A v1 é a versão atual e não tem data de encerramento.
Limites de requisições
Os endpoints públicos de descoberta (busca, MCP, negociação de markdown/JSON) retornam os cabeçalhos IETF RateLimit / RateLimit-Policy em todas as respostas, além de RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. Um 429 inclui Retry-After. Veja a referência da API do Fluos.