Référence API
BotLaunch API
Créez des intégrations puissantes avec l'API REST de BotLaunch. AccÚs complet aux bots, utilisateurs, messages et plus encore avec une documentation et des exemples complets.
URL de base
https://api.botlaunch.io
Version
v1.0
Auth
JWT Bearer
Démarrage rapide
Soyez opérationnel avec l'API BotLaunch en quelques minutes.
1. Installer ou tester
# Install the BotLaunch SDK
npm install @botlaunch/sdk
# Or use the REST API directly
curl -X GET "https://api.botlaunch.io/api/health" \
-H "Content-Type: application/json"bash
2. S'authentifier
// Authenticate and get an access token
const response = await fetch("https://api.botlaunch.io/api/auth/login", {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
email: "your@email.com",
password: "your-password"
})
});
const { data } = await response.json();
console.log(data.accessToken);javascript
3. Effectuer des appels API
// Make authenticated API calls
const bots = await fetch("https://api.botlaunch.io/api/bots", {
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"x-organization-id": "YOUR_ORG_ID"
}
});
const { data } = await bots.json();
console.log(data); // Array of your botsjavascript
Endpoints API
Explorez les endpoints API disponibles organisés par type de ressource.
Format de réponse
Toutes les réponses API suivent une structure JSON cohérente.
Réponse de succÚs
{
"data": {
"id": "bot_123",
"name": "My Bot",
"status": "active"
},
"message": "Bot retrieved successfully"
}json
Réponse d'erreur
{
"error": "Unauthorized",
"statusCode": 401,
"message": "Invalid or expired token"
}json
Réponse paginée
{
"data": [
{ "id": "bot_1", "name": "Bot 1" },
{ "id": "bot_2", "name": "Bot 2" }
],
"total": 25,
"page": 1,
"limit": 10
}json
Limitation de débit
Les requĂȘtes API sont limitĂ©es en dĂ©bit pour garantir une utilisation Ă©quitable et la stabilitĂ© de la plateforme.
| Plan | RequĂȘtes/Min | RequĂȘtes/Jour | Limite de rafale |
|---|---|---|---|
| Free | 60 | 1,000 | 10 |
| Starter | 300 | 10,000 | 50 |
| Professional | 1,000 | 50,000 | 100 |
| Business | 5,000 | Unlimited | 500 |
| Enterprise | Custom | Unlimited | Custom |
En-tĂȘtes de limitation de dĂ©bit
Check X-RateLimit-Remaining and X-RateLimit-Reset headers in API responses to monitor your usage.