SMS, OTP ve webhook — tek REST API.
Uygulamanızdan SMS ve OTP gönderin, gönderimleri zamanlayın, rehberinizi yönetin; teslim raporlarını ve gelen SMS'leri webhook ile kendi sunucunuza alın.
https://api.turkeysms.com.tr
API ile neler yapabilirsiniz
SMS gönderimi
Bir veya birden fazla numaraya anında ya da zamanlanmış gönderim; tek istekte çok sayıda numaraya aynı metin veya numara başına farklı metin.
/sms/send/group/send/group/sendMixedOTP doğrulama
Doğrulama kodunu TurkeySMS üretir; kodu hazır şablonla ya da kendi SMS başlığınız ve metninizle tek numaraya gönderin.
/otp/send/otp/detailedWebhook
Olaylar sunucunuza HTTP POST ile gelir: sms.sent, sms.delivered, sms.failed, sms.received. Secret tanımlıysa istekler HMAC ile imzalanır.
Rehber ve numara engelleme
Grupları oluşturun, yeniden adlandırın, silin ve listeleyin; gruplara numara ekleyin. Engelleme listesine numara ekleyin ve durumunu sorgulayın (liste panel gönderimlerinde uygulanır).
/groups/*/contacts/add/blacklist/post/*Sorgular ve raporlar
Bakiyenizi, SMS başlıklarınızı ve mesaj durumunu sorgulayın; özet ve ayrıntılı gönderim raporlarını alın.
/balance//senderid/check/sms/status/reports/*API anahtarları ve izinler
Anahtarınızı doğrulayın; her anahtarın izinlerini panelde API Merkezi → Anahtarlarım bölümünden yönetin.
/auth/post/check/İlk isteğiniz
API anahtarınızı ve onaylı SMS başlığınızı yazın, isteği gönderin. Anahtar gövdedeki api_key alanında gönderilir.
curl -X POST https://api.turkeysms.com.tr/sms/send \ -H "Content-Type: application/json" \ -d '{ "api_key": "API_ANAHTARINIZ", "title": "BASLIGINIZ", "sentto": "905XXXXXXXXX,905YYYYYYYYY", "text": "Randevunuz yarın saat 10:00.", "sms_lang": 1 }'
{
"result": true,
"result_code": "TS-1024",
"result_message": "SMS dispatched successfully.",
"sms_id": 48213377,
"number_of_sms": 2,
"total_recipients": 2,
"success_count": 2
}
İstekler canlıdır
Bu adrese gönderilen her istek gerçek olarak işlenir: /sms/send gerçek SMS gönderir; ücreti bakiyenizden düşülür. Swagger UI'dan gönderilen istekler de canlıdır; «Try it out» bu yüzden varsayılan olarak kapalıdır.
Denemeleri kendi numaranızla yapın; API anahtarınızı tarayıcıda veya mobil uygulamada çalışan koda koymayın.
HTTPS, POST ve JSON
Tüm istekler HTTPS üzerinden POST ile gönderilir; gövde JSON veya form verisi olabilir, yanıtlar JSON'dur.
Açık yanıt kodları
Sonuç ve hata kodları (TS-xxxx) yanıt gövdesinde döner; sonucu HTTP koduna göre değil gövdeye göre değerlendirin. Tüm kodlar Yanıt kodları bölümünde.
OpenAPI 3.1
Spesifikasyonu indirip API istemcinize veya kod üreticinize aktarın.