Loslegen

Bulk SMS API-Referenz

BulkSMSAPI ist eine Bulk-SMS-API für Entwickler: Senden Sie eine Nachricht oder einen Batch mit bis zu 10.000 Nummern pro Anfrage in 227 Länder über REST, verfolgen Sie jede Nachricht mit signierten Webhooks und zahlen Sie pro Nachricht von einem Prepaid-Guthaben. Diese Referenz deckt jeden Endpunkt, jedes Feld, jedes Ereignis und jeden Fehler der API ab. Jede Seite ist auch als Markdown verfügbar: Fügen Sie .md zur Adresse hinzu.

Basis-URL und Format

Alle Anfragen gehen über HTTPS an https://bulksmsapi.cc/v1. Die Inhalte sind JSON (Content-Type: application/json, UTF-8), und jede Antwort ist JSON, einschließlich Fehler. Zeiten sind ISO 8601 in UTC. Geldbeträge sind Zeichenketten in US-Dollar mit fünf Dezimalstellen ("0.00507"), sodass Preise unter einem Cent exakt sind.

Endpunkte

Methode und PfadFunktionKey
POST /v1/messagesSende einen Text an eine NummerYes
POST /v1/batchesSende an bis zu 10.000 Nummern, einen Text oder einen pro NummerYes
GET /v1/messages/{id}Eine Nachricht mit Status und PreisYes
GET /v1/messagesNachrichten, neueste zuerst, nach Batch oder Status filternYes
GET /v1/batches/{id}Ein Batch mit Anzahl pro StatusYes
GET /v1/batchesBatches, neueste zuerstYes
POST /v1/batches/{id}/cancelEinen geplanten Batch stornieren, vollständige RückerstattungYes
POST /v1/estimatesEine Anfrage bewerten, ohne sie zu sendenYes
GET /v1/balanceGuthaben in USDYes
GET /v1/pricingPreis pro Segment für jedes LandNo
GET /v1/pricing/{country}Preis für ein Land (ISO-Code)No

Eine erste Anfrage

Erstellen Sie einen API-Schlüssel in der Konsole, exportieren Sie ihn und senden Sie eine Nachricht. Die Antwort ist 202 mit dem Nachrichtenobjekt: Die Kosten werden vom Guthaben abgezogen und die Nachricht wird in die Warteschlange gestellt.

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155550123",
    "text": "Your Northwind code is 482913. It expires in 10 minutes.",
    "reference": "login-7781"
  }'
202 AcceptedJSON
{
  "id": "msg_8F3K2Q9TZ1MX",
  "object": "message",
  "batch_id": "bat_4M7Q1X0PK2RS",
  "to": "+14155550123",
  "country": "US",
  "text": "Your Northwind code is 482913. It expires in 10 minutes.",
  "segments": 1,
  "price": "0.00507",
  "currency": "USD",
  "status": "queued",
  "error": null,
  "reference": "login-7781",
  "created_at": "2026-11-07T09:30:12.418Z",
  "sent_at": null,
  "done_at": null
}

Wie eine Nachricht verarbeitet wird

Akzeptierte Nachrichten werden queued (oder scheduled, wenn die Anfrage send_at enthält). Die Warteschlange übergibt sie alle zwei Sekunden an das Netzwerk, bis zu 1.200 pro Minute pro Konto, und sie werden sent. Der endgültige Status ist delivered oder failed; eine fehlgeschlagene Nachricht wird sofort auf das Guthaben zurückerstattet. Jeder endgültige Status ruft Ihren Webhook mit einem signierten Ereignis auf.

Limits auf einen Blick

LimitWert
Empfänger pro API-Anfrage10,000
Empfänger pro Konsolenkampagne50,000
Anfragen pro Minute pro Schlüssel600
Nachrichten, die pro Minute pro Konto an das Netzwerk übergeben werden1,200
Längster Text10 Segmente (1.530 GSM-7 oder 670 UCS-2 Zeichen)
Zeitfenster für die Planung2 Minuten bis 45 Tage im Voraus
Webhook-Versuche pro Ereignis10
Idempotency-Key Speicher24 Stunden
API-Schlüssel pro Konto10

Maschinenlesbare Dateien

Bulk SMS API-Referenz | BulkSMSAPI Dokumentation