API-Referenz

BotLaunch API

Erstellen Sie leistungsstarke Integrationen mit der BotLaunch REST API. Vollständiger Zugriff auf Bots, Benutzer, Nachrichten und mehr mit umfassender Dokumentation und Beispielen.

Basis-URL

https://api.botlaunch.io

Version

v1.0

Auth

JWT Bearer

Schnellstart

Starten Sie mit der BotLaunch API in wenigen Minuten.

1. Installieren oder Testen

# 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. Authentifizieren

// 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. API-Aufrufe durchführen

// 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

API-Endpunkte

Erkunden Sie die verfügbaren API-Endpunkte, geordnet nach Ressourcentyp.

Authentifizierung

Erfahren Sie mehr über JWT-Tokens, API-Schlüssel und sichere Authentifizierungsmethoden.

Dokumentation ansehen

Bots

Erstellen, konfigurieren und verwalten Sie Ihre Telegram-Bots programmatisch.

Dokumentation ansehen

Benutzer

Verwalten Sie Benutzer, Berechtigungen und Organisationsmitglieder.

Dokumentation ansehen

Nachrichten

Senden Sie Nachrichten, verarbeiten Sie Callbacks und verwalten Sie Konversationen.

Dokumentation ansehen

Webhooks

Konfigurieren Sie Webhooks, um Echtzeit-Events und Benachrichtigungen zu erhalten.

Dokumentation ansehen

Antwortformat

Alle API-Antworten folgen einer einheitlichen JSON-Struktur.

Erfolgreiche Antwort

{
  "data": {
    "id": "bot_123",
    "name": "My Bot",
    "status": "active"
  },
  "message": "Bot retrieved successfully"
}

json

Fehlerantwort

{
  "error": "Unauthorized",
  "statusCode": 401,
  "message": "Invalid or expired token"
}

json

Paginierte Antwort

{
  "data": [
    { "id": "bot_1", "name": "Bot 1" },
    { "id": "bot_2", "name": "Bot 2" }
  ],
  "total": 25,
  "page": 1,
  "limit": 10
}

json

Ratenbegrenzung

API-Anfragen sind ratenbegrenzt, um faire Nutzung und Plattformstabilität zu gewährleisten.

Plan	Anfragen/Min	Anfragen/Tag	Burst-Limit
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

Ratenbegrenzungs-Header

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

Zurück zur Doku Authentifizierung