Referencia de la API Fluos
API HTTP pública de Fluos — archivos de descubrimiento, documentación, búsqueda y webhooks entrantes — descrita en /openapi.json.
La descripción máquina-lectible canónica de la API Fluos es https://www.fluos.io/openapi.json. Cada operación tiene un operationId único, una descripción, parámetros tipados y esquemas de respuesta para que los agentes puedan registrar herramientas de llamadas a funciones desde la especificación.
URL base
https://www.fluos.io
Prefijo público canónico de la API: /api/v1/. Envía API-Version: 1. Consulta versionado y obsolescencia de la API Fluos.
Descubrimiento
| operationId | Método | Ruta | Propósito |
|---|---|---|---|
getFluosOpenApiSpec | GET | /openapi.json | Esta especificación |
getFluosOpenApiSpecV1 | GET | /api/v1/openapi.json | Alias versionado de esta especificación |
getFluosMcpServerCard | GET | /api/v1/mcp | Tarjeta del servidor MCP Fluos |
callFluosMcp | POST | /api/v1/mcp | Fluos MCP JSON-RPC |
getFluosLlmsTxt | GET | /llms.txt | Índice de URLs seleccionadas |
getFluosLlmsFullTxt | GET | /llms-full.txt | Descarga de documentos completos |
getFluosAiTxt | GET | /ai.txt | Política del rastreador IA |
getFluosSitemap | GET | /sitemap.xml | Todas las URLs públicas |
getFluosRobotsTxt | GET | /robots.txt | Reglas del rastreador |
getFluosRssFeed | GET | /feed.xml | RSS del blog |
Estos endpoints son públicos y cachables. No se requiere autenticación.
Contenido (Negociación de Accept)
| operationId | Método | Ruta |
|---|---|---|
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} |
Envía Accept: text/markdown para Markdown. Si falta Accept, devuelve HTML. Los valores incompatibles de Accept devuelven 406.
Buscar
| operationId | Método | Ruta | Parámetros |
|---|---|---|---|
searchFluosDocs | GET | /api/search | query (o alias q) |
searchFluosDocsV1 | GET | /api/v1/search | query (o alias q) |
Público. Devuelve los resultados de fumadocs/Orama para este conjunto de documentación. Prefiere /api/v1/search. Las respuestas incluyen cabeceras IETF RateLimit; 429 incluye Retry-After.
Webhooks entrantes
Estos solo aceptan POST firmados por el proveedor. Consulta Fluos webhooks.
| operationId | Método | Ruta |
|---|---|---|
receiveClerkWebhook | POST | /api/webhooks/clerk |
receiveStripeWebhook | POST | /api/stripe/webhook |
receiveResendWebhook | POST | /api/webhooks/resend |
Errores
| Estado | Cuándo |
|---|---|
404 | Ruta desconocida. El cuerpo de Markdown enumera /sitemap.xml, /llms.txt, /docs, /docs/developers, /openapi.json. |
406 | Accept rechazó HTML y Markdown. |
401 | API del producto autenticada sin sesión de Clerk. JSON { "error", "code": "unauthorized" }. |
Llamadas a funciones
Importa /openapi.json y registra cada operationId como una herramienta. Prefiere la detección + searchFluosDocs + Markdown getFluosDocPage antes de responder preguntas sobre el producto. No llames a operaciones de webhook desde un agente — requieren secretos del proveedor.