Documentation API publique
Apantio AI expose une petite surface de découverte publique afin que les agents trouvent la documentation, le statut, les métadonnées OpenAPI, les skills et les préférences lisibles par machine sans scraper le site.
Ces endpoints publics ne demandent pas d’authentification. Les métadonnées OAuth seront publiées sur l’hôte applicatif lorsque les API protégées exposeront de vrais endpoints d’autorisation.
Catalogue API
Linkset RFC 9727 pour les ressources publiques d’API et de découverte.
OpenAPI
Description JSON des endpoints publics de découverte.
Statut
Signal de santé public léger pour les clients automatisés.
À qui s’adresse cette surface de découverte
Ces endpoints aident les développeurs, moteurs de recherche, agents IA, lecteurs de flux et outils d’intégration à trouver la documentation publique et les ressources lisibles par machine de Apantio AI. Ils ne constituent pas un plan de contrôle authentifié pour les comptes ou appels clients.
Accès et comportement des réponses
- • Les endpoints publics de découverte acceptent les requêtes GET ou HEAD sans authentification.
- • L’endpoint de statut indique la santé publique du service sans exposer de données opérationnelles ou de locataire.
- • Les API applicatives protégées sont documentées séparément et utilisent la méthode d’authentification publiée par l’hôte applicatif.
- • La page d’accueil prend en charge la négociation Accept: text/markdown; les autres représentations Markdown publiées sont disponibles aux endpoints .md indiqués ci-dessous.
Endpoints de découverte
| Endpoint | Type de contenu | Objectif |
|---|---|---|
| /.well-known/api-catalog | application/linkset+json | Linkset du catalogue API. |
| /openapi.json | application/vnd.oai.openapi+json | Description OpenAPI du service. |
| /llms.txt | text/plain | Contexte compact produit, fonctionnalités, tarifs et découverte pour les LLM. |
| /feed.xml | application/rss+xml | Flux RSS complet pour la découverte du blog. |
| /schemamap.xml | application/xml | Carte de découverte des données structurées. |
| /schema/page.json | application/ld+json | Graphe JSON-LD des pages publiques. |
| /schema/post.json | application/ld+json | Graphe JSON-LD des articles de blog. |
| /fr/index.md | text/markdown | Résumé de la page d’accueil en markdown. |
| /fr/features.md | text/markdown | Résumé des fonctionnalités en markdown. |
| /fr/pricing.md | text/markdown | Tarifs, volume inclus, règles et dépassements en markdown. |
| /.well-known/agent-skills/index.json | application/json | Index de découverte des agent skills. |
| /.well-known/mcp/server-card.json | application/json | Carte serveur MCP. |
Exemples de requêtes
Négociation Markdown de l’accueil
curl https://apantio.com/fr/ \
-H "Accept: text/markdown"Catalogue API
curl https://apantio.com/.well-known/api-catalog \
-H "Accept: application/linkset+json"Ressources associées
Fonctionnalités produit
Découvrez comment Apantio AI gère la réponse, la réservation, les transferts et le suivi.
Tarifs et usage
Consultez les minutes incluses, les dépassements et les limites avant d’intégrer.
Fichier de contexte LLM
Contexte compact produit, tarifs et découverte dans llms.txt pour les clients automatisés.
Documentation produit complète
Consultez les guides de configuration, déploiement, téléphonie, réservation et exploitation de Apantio AI.