Başlayın

Toplu SMS API referansı

BulkSMSAPI, geliştiriciler için bir toplu SMS API'sidir: REST üzerinden 227 ülkeye tek bir metin veya istek başına 10.000 numaraya kadar bir grup gönderin, her mesajı imzalı webhook'larla takip edin ve ön ödemeli bakiyeden mesaj başına ödeme yapın. Bu referans, API'nin sahip olduğu her endpoint, alan, olay ve hatayı kapsar. Her sayfa aynı zamanda Markdown olarak da mevcuttur: adresine .md ekleyin.

Temel URL ve format

Tüm istekler HTTPS üzerinden https://bulksmsapi.cc/v1 adresine gider. Gövdeler JSON'dur (Content-Type: application/json, UTF-8) ve her yanıt, hatalar dahil JSON'dur. Zamanlar UTC'de ISO 8601 formatındadır. Para, beş ondalık basamaklı ABD doları cinsinden bir string'dir ("0.00507"), böylece bir sentin altındaki fiyatlar kesindir.

Endpoint'ler

Metod ve yolNe yaparKey
POST /v1/messagesBir numaraya bir metin gönderYes
POST /v1/batches10.000 numaraya kadar gönderim, tek metin veya numara başına bir taneYes
GET /v1/messages/{id}Durumu ve fiyatıyla bir mesajYes
GET /v1/messagesMesajlar, en yeniden eskiye, parti veya duruma göre filtreleYes
GET /v1/batches/{id}Durum başına sayılarla bir partiYes
GET /v1/batchesPartiler, en yeniden eskiyeYes
POST /v1/batches/{id}/cancelPlanlanmış bir partiyi iptal et, tam geri ödemeYes
POST /v1/estimatesGöndermeden bir isteği fiyatlandırYes
GET /v1/balanceBakiye (USD)Yes
GET /v1/pricingHer ülke için segment başına fiyatNo
GET /v1/pricing/{country}Bir ülke için fiyat (ISO kodu)No

İlk istek

Konsolda bir API anahtarı oluşturun, dışa aktarın ve bir mesaj gönderin. Yanıt, mesaj nesnesiyle birlikte 202 olacaktır: maliyet bakiyeden alınır ve mesaj sıraya alınır.

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
}

Bir mesajın yolculuğu

Kabul edilen mesajlar queued (veya scheduled eğer istekte send_at varsa) olur. Kuyruk, bunları her iki saniyede bir ağa aktarır, hesap başına dakikada 1.200'e kadar, ve sent olurlar. Son durum delivered veya failed olur; başarısız bir mesajın maliyeti hemen bakiyeye iade edilir. Her son durum, imzalı bir etkinlikle webhook'unuzu çağırır.

Sınırlara genel bakış

LimitDeğer
API isteği başına alıcı sayısı10,000
Konsol kampanyası başına alıcı sayısı50,000
Anahtar başına dakikada istek sayısı600
Hesap başına dakikada ağa aktarılan mesaj sayısı1,200
En uzun metin10 segment (1.530 GSM-7 veya 670 UCS-2 karakter)
Planlama penceresi2 dakika ile 45 gün öncesi
Etkinlik başına webhook denemesi sayısı10
Idempotency-Key belleği24 saat
Hesap başına API anahtarı sayısı10

Makine tarafından okunabilir dosyalar

Toplu SMS API referansı | BulkSMSAPI Docs