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 bots
javascript

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.

PlanRequĂȘtes/MinRequĂȘtes/JourLimite de rafale
Free601,00010
Starter30010,00050
Professional1,00050,000100
Business5,000Unlimited500
EnterpriseCustomUnlimitedCustom

En-tĂȘtes de limitation de dĂ©bit

Check X-RateLimit-Remaining and X-RateLimit-Reset headers in API responses to monitor your usage.