Référence de l’API Fluos
API HTTP publique de Fluos — fichiers de découverte, documentation, recherche et opérations vidéo payantes — décrite par /openapi.json.
La description canonique de l’API Fluos, lisible par machine, est https://www.fluos.io/openapi.json. Chaque opération possède un operationId unique, une description, des paramètres typés et des schémas de réponse, afin que les agents puissent enregistrer des outils d’appel de fonctions à partir de la spécification.
URL de base
https://www.fluos.io
Préfixe d’API public canonique : /api/v1/. Envoyez API-Version: 1. Voir Versionnage et dépréciation de l’API Fluos.
Découverte
| operationId | Méthode | Chemin | Objet |
|---|---|---|---|
getFluosOpenApiSpec | GET | /openapi.json | Cette spécification |
getFluosOpenApiSpecV1 | GET | /api/v1/openapi.json | Alias versionné de cette spécification |
getFluosMcpServerCard | GET | /api/v1/mcp | Fiche du serveur MCP Fluos |
callFluosMcp | POST | /api/v1/mcp | JSON-RPC du MCP Fluos |
getFluosLlmsTxt | GET | /llms.txt | Index d’URL sélectionnées |
getFluosLlmsFullTxt | GET | /llms-full.txt | Export intégral de la documentation en texte |
getFluosAiTxt | GET | /ai.txt | Politique pour les robots d’IA |
getFluosSitemap | GET | /sitemap.xml | Toutes les URL publiques |
getFluosRobotsTxt | GET | /robots.txt | Règles pour les robots d’exploration |
getFluosRssFeed | GET | /feed.xml | Flux RSS du blog |
Ces points d’accès sont publics et peuvent être mis en cache. Aucune authentification.
Contenu (négociation via Accept)
| operationId | Méthode | Chemin |
|---|---|---|
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} |
Envoyez Accept: text/markdown pour obtenir du Markdown. Sans Accept, la réponse est en HTML. Les valeurs Accept incompatibles renvoient 406.
Recherche
| operationId | Méthode | Chemin | Paramètres |
|---|---|---|---|
searchFluosDocs | GET | /api/search | query (ou l’alias q) |
searchFluosDocsV1 | GET | /api/v1/search | query (ou l’alias q) |
Public. Renvoie des résultats classés sur cette documentation. Préférez /api/v1/search. Les réponses incluent les en-têtes IETF RateLimit ; 429 inclut Retry-After.
Erreurs
| Statut | Quand |
|---|---|
404 | Chemin inconnu. Le corps Markdown liste /sitemap.xml, /llms.txt, /docs, /docs/developers, /openapi.json. |
406 | Accept a rejeté à la fois HTML et Markdown. |
401 | API authentifiée sans session ni jeton. JSON { "error", "code": "unauthorized" }. |
Appel de fonctions
Importez /openapi.json et enregistrez chaque operationId comme un outil. Privilégiez la découverte, puis searchFluosDocs et getFluosDocPage en Markdown avant de répondre à des questions sur le produit.