Page Documentation API

Adresse : https://botillon.fr/api-docs

La page API documente les endpoints publics et les endpoints authentifiés par clé de projet. Elle indique les paramètres, les réponses, les erreurs et les limites.

Endpoints publics

• GET /api/v1/bots
• GET /api/v1/bots/{id}
• GET /api/v1/bots/{id}/stats
• GET /api/v1/bots/{id}/community
• GET /api/v1/users/{id}

Ils sont en lecture seule, sans clé, limités par IP. Les profils privés sont anonymisés.

Endpoints projet

• GET/PATCH /api/v1/me
• GET/PUT/PATCH/DELETE /api/v1/me/commands
• GET /api/v1/me/check/{user_id}
• GET /api/v1/me/votes, /likes, /comments, /stats, /rank

Ils demandent Authorization: Bearer blp_…. La clé est liée à un seul bot.

MCP

La page renvoie aussi vers /mcp et /api/mcp pour les assistants. Le serveur est en lecture seule, sans clé.

Erreurs

• 401 : clé absente ou invalide.
• 403 : projet non autorisé.
• 404 : ressource inconnue.
• 429 : quota dépassé ; respectez Retry-After.

Exemple de requête

curl -H "Authorization: Bearer $BOTILLON_API_KEY" \
  https://botillon.fr/api/v1/me

Les endpoints publics ne demandent pas cette en-tête. Une clé de projet ne permet jamais de voter, liker ou publier un avis. Pour les tests, utilisez une clé de développement et révoquez-la après usage.

Voir aussi

• Créer une clé API
• Authentification API
• Rate limits
• Serveur MCP