Geliştirici

Toptan SMS API Dokümantasyonu

REST API ile SMS gönderimi, durum takibi ve webhook entegrasyonu. Node.js, PHP, Python örnekleri.

Hızlı Başlangıç

1. API Anahtarını Alın

Panel → Ayarlar → API Anahtarları bölümünden yeni bir anahtar oluşturun.

Hemen Başla

2. Postman Collection

Hazır API koleksiyonunu indirerek hızla test etmeye başlayın.

SMS Gönderimi

Tekil veya toplu SMS gönderimi için kullanın

POST/v1/messages/send

curl -X POST https://api.toptansms.com/v1/messages/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+905551234567",
    "message": "Merhaba {name}, kampanyamızdan haberdar olmak için: {link}",
    "sender": "TOPTANSMS",
    "variables": {
      "name": "Ahmet",
      "link": "https://toptansms.com"
    }
  }'

Durum Sorgulama

Gönderilen SMS'in teslimat durumunu sorgulayın

GET/v1/messages/status/:id

curl -X GET https://api.toptansms.com/v1/messages/status/MSG_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Webhook Entegrasyonu

Teslimat raporlarını otomatik olarak alın

// Express.js webhook endpoint
app.post('/webhook/dlr', (req, res) => {
  const { message_id, status, operator, delivered_at } = req.body;
  
  // SMS Status Update: {
    message_id,
    status, // SENT, DELIVERED, FAILED, EXPIRED, REJECTED
    operator,
    delivered_at
  });
  
  // Process the delivery report
  updateMessageStatus(message_id, status);
  
  res.status(200).json({ success: true });
});

HTTP Durum Kodları

Kod	Mesaj	Açıklama
200	OK	İstek başarıyla işlendi
400	Bad Request	Geçersiz istek parametreleri
401	Unauthorized	Geçersiz API anahtarı
403	Forbidden	İzin reddedildi
429	Too Many Requests	Hız limiti aşıldı
500	Internal Server Error	Sunucu hatası

Hız Limitleri

500

İstek/dakika

5.000

SMS/dakika

99.5%

Uptime SLA