Referência da API do Fluos
API HTTP pública do Fluos — arquivos de descoberta, documentação, busca e operações pagas de vídeo — descrita em /openapi.json.
A descrição canônica da API do Fluos, legível por máquina, é https://www.fluos.io/openapi.json. Cada operação tem um operationId único, uma descrição, parâmetros tipados e esquemas de resposta, para que agentes possam registrar ferramentas de function calling a partir da especificação.
URL base
https://www.fluos.io
Prefixo público canônico da API: /api/v1/. Envie API-Version: 1. Veja Versionamento e descontinuação da API do Fluos.
Descoberta
| operationId | Método | Caminho | Finalidade |
|---|---|---|---|
getFluosOpenApiSpec | GET | /openapi.json | Esta especificação |
getFluosOpenApiSpecV1 | GET | /api/v1/openapi.json | Alias versionado desta especificação |
getFluosMcpServerCard | GET | /api/v1/mcp | Card do servidor MCP do Fluos |
callFluosMcp | POST | /api/v1/mcp | JSON-RPC do MCP do Fluos |
getFluosLlmsTxt | GET | /llms.txt | Índice curado de URLs |
getFluosLlmsFullTxt | GET | /llms-full.txt | Dump completo da documentação em texto |
getFluosAiTxt | GET | /ai.txt | Política para crawlers de IA |
getFluosSitemap | GET | /sitemap.xml | Todas as URLs públicas |
getFluosRobotsTxt | GET | /robots.txt | Regras para crawlers |
getFluosRssFeed | GET | /feed.xml | RSS do blog |
Esses endpoints são públicos e podem ser armazenados em cache. Não exigem autenticação.
Conteúdo (negociação por Accept)
| operationId | Método | Caminho |
|---|---|---|
getFluosHome | GET | / |
getFluosCli | GET | /cli |
getFluosMcp | GET | /mcp |
getFluosDocsIndex | GET | /docs |
getFluosDocPage | GET | /docs/{slug} |
getFluosAbout | GET | /about |
getFluosPricing | GET | /pricing |
getFluosBlogPost | GET | /blog/{slug} |
Envie Accept: text/markdown para receber Markdown. Sem Accept, a resposta é HTML. Valores de Accept incompatíveis retornam 406.
Busca
| operationId | Método | Caminho | Parâmetros |
|---|---|---|---|
searchFluosDocs | GET | /api/search | query (ou o alias q) |
searchFluosDocsV1 | GET | /api/v1/search | query (ou o alias q) |
Pública. Retorna resultados ranqueados sobre este conjunto de documentação. Prefira /api/v1/search. As respostas incluem cabeçalhos IETF RateLimit; o 429 inclui Retry-After.
Erros
| Status | Quando |
|---|---|
404 | Caminho desconhecido. O corpo em Markdown lista /sitemap.xml, /llms.txt, /docs, /docs/developers, /openapi.json. |
406 | O Accept recusou HTML e Markdown. |
401 | API autenticada sem sessão ou token. JSON { "error", "code": "unauthorized" }. |
Function calling
Importe /openapi.json e registre cada operationId como uma ferramenta. Prefira descoberta + searchFluosDocs + getFluosDocPage em Markdown antes de responder perguntas sobre o produto.