SMS API: uygulamalarınızdan kurumsal gönderim

Hızlı başlangıç

1. Panelde hesabınızı açın ve paket yükleyin.
2. Ayarlar bölümünden API anahtarınızı oluşturun.
3. Onaylı gönderici başlığınızı sender alanında kullanın.
4. Aşağıdaki örnek isteği kendi bilgilerinizle çalıştırın.
5. Yanıtta dönen batch_id ile gönderimi panelden veya API'den sorgulayın.

Gönderim isteği

cURL

curl -X POST "https://panel.oncusms.com.tr/api/v1/sms/send" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": "ONCUSMS",
    "type": "bulk",
    "messages": [
      { "to": "905551112233", "text": "Sayin Ahmet Bey, randevunuz yarin saat 10:00." },
      { "to": "905559998877", "text": "Sayin Ayse Hanim, randevunuz yarin saat 11:30." }
    ]
  }'

Yanıt

{
  "status": "accepted",
  "batch_id": "b_20261017_000481",
  "total": 2,
  "segments": 2,
  "balance": 9998
}

PHP ile OTP gönderimi

PHP

<?php
$payload = [
    'sender' => 'ONCUSMS',
    'type'   => 'otp',
    'messages' => [
        ['to' => '905551112233', 'text' => 'Dogrulama kodunuz: 482915'],
    ],
];

$ch = curl_init('https://panel.oncusms.com.tr/api/v1/sms/send');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer API_ANAHTARINIZ',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 10,
]);
$response = curl_exec($ch);
$code     = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

Teslim bildirimi (callback)

Panelde tanımladığınız adrese, mesaj durumu değiştiğinde aşağıdaki gibi bir POST isteği gönderilir. Uç noktanız 200 kodu döndürmelidir; aksi halde bildirim belirli aralıklarla yeniden denenir.

Callback gövdesi

{
  "batch_id": "b_20261017_000481",
  "to": "905551112233",
  "status": "delivered",
  "delivered_at": "2026-10-17T21:14:09+03:00"
}