JSON · HTTPS · Bearer anahtarı
Tek SMS API ile doğrulama kodu alın ve SMS gönderin
TODAY SMS API, tek kullanımlık numaralarda kod almaya yarayan SMS doğrulama API'si ile 227 ülkeye gönderim yapan SMS gönderim API'sini tek API anahtarı ve tek bakiyede birleştiren bir geliştirici API'sidir. Tüm istek ve yanıtlar JSON'dur; fiyatlar ve iade kuralları web sitesiyle aynıdır.
$ curl -X POST https://today-sms.com/api/v1/numbers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"app":"telegram","country":"indonesia"}'
{
"id": "N-7K2M-QX4P-9D3A",
"phone": "+6281234567890",
"price": "0.4515",
"status": "waiting",
"expires_at": "2026-10-18T09:20:00.000Z"
}
$ curl https://today-sms.com/api/v1/numbers/N-7K2M-QX4P-9D3A \
-H "Authorization: Bearer YOUR_API_KEY"
{
"id": "N-7K2M-QX4P-9D3A",
"status": "received",
"sms": [
{ "code": "482913", "text": "Your code is 482913", "at": "2026-10-18T09:02:11.000Z" }
]
}
$ curl -X POST https://today-sms.com/api/v1/messages \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to":["+14155550100","+447700900123"],"text":"Your code is 482913"}'
{
"id": "m_7Q2K9X",
"status": "queued",
"recipients": 2,
"parts": 1,
"encoding": "GSM-7",
"cost": "0.0136"
}
$ curl https://today-sms.com/api/v1/messages/m_7Q2K9X \
-H "Authorization: Bearer YOUR_API_KEY"
- Dakikada 300 istek
- Alma ve gönderme için tek anahtar
- Başarısız veya gelmeyenler bakiyeye iade
- 12 kripto yöntemiyle kredi yükle
SMS API ile neler yapabilirsiniz
SMS doğrulama API'si
Uygulama ve ülke seçin, numara satın alın ve doğrulama kodu için durumunu sorgulayın. SMS gelmezse süre dolduğunda tutarın tamamı bakiyenize döner.
SMS gönderim API'si
Mesajınızı aynı anda 1,000 alıcıya kadar gönderin ve her alıcı için iletim raporu alın. Planlı bir zaman ekleyerek o saatte gönderin.
Fiyat ve stok API'si
Uygulama başına ülkeleri ve fiyatları, numara sayılarını ve her ülkenin SMS başına fiyatını API ile alın ve kendi hizmetinizde olduğu gibi gösterin.
Tek bakiye
Alma ve gönderme aynı bakiyeyi kullanır. Bakiyeyi USDT ile yükleyin ve istediğiniz zaman API ile kontrol edin.
Yöntemlere genel bakış
Tüm belgeler| Yöntem | Ne yapar |
|---|---|
| GET/balance | Bakiyeyi al |
| GET/apps | Uygulamaları listele |
| GET/prices?app=telegram | Bir uygulamanın ülkeleri ve fiyatları |
| POST/numbers | Numara satın al |
| GET/numbers/{id} | Numara durumu ve SMS'ler |
| POST/numbers/{id}/cancel | Numarayı iptal et |
| POST/numbers/{id}/finish | Numarayı tamamla |
| GET/messages/prices | Ülkeye göre SMS fiyatları |
| POST/messages | SMS gönder |
| GET/messages/{id} | Gönderim durumu ve iletim raporları |
| POST/messages/{id}/cancel | Planlı gönderimi iptal et |
SMS API nedir?
SMS API, yazılımınızın HTTP istekleriyle SMS almasını veya göndermesini sağlayan bir bağlantıdır. Bir kişinin web ekranında tıklayacağı işleri kod yapar; böylece otomatik kayıt testleri, doğrulama kodu gönderimi ve sipariş bildirimleri gibi tekrarlanan işler kimse elini sürmeden yürür.
TODAY SMS API iki şeyi bir arada sunar. Biri, tek kullanımlık numaralarda uygulama doğrulama kodları almak için SMS doğrulama API'si (SMS activation API), diğeri dünya genelindeki cep telefonlarına SMS göndermek için SMS gönderim API'sidir. İkisi de aynı URL'yi, aynı API anahtarını ve aynı bakiyeyi kullanır; ayrı kayıt veya ayrı yükleme gerekmez.
SMS doğrulama API'si nasıl kullanılır?
Dört adımdan oluşur. GET /apps ile bir uygulama kodu seçin, GET /prices?app=CODE ile ülkeleri ve fiyatları görün. POST /numbers ile numara satın alıp numarayı ve id'sini alın, ardından kodun gelip gelmediğini kontrol etmek için birkaç saniyede bir GET /numbers/{id} çağırın. Kodu aldığınızda numarayı POST /numbers/{id}/finish ile kapatın.
Her numara SMS için 20 dakika bekler ve bu sürede aynı numaraya gelen SMS'ler ek ücretsizdir. SMS gelmezse süre dolduğunda tutarın tamamı bakiyenize döner; hiçbir şey gelmediyse satın aldıktan 120 saniye sonrasından itibaren POST /numbers/{id}/cancel ile kendiniz iptal edebilirsiniz. Uygulama doğrulama otomasyonuna veya toplu sanal numara API'sine ihtiyacınız olduğunda bu akışı tekrarlamanız yeterli.
SMS gönderim API'si nasıl kullanılır?
POST /messages adresine alıcı listesini (to) ve mesaj metnini (text) gönderin; mesaj id'si, alıcı sayısı, parça sayısı ve toplam maliyet döner. Alıcıları + ve ülke koduyla uluslararası biçimde, istek başına en fazla 1,000 olarak girin. Planlamak için at alanına bir UTC zamanı yazın.
Gönderdikten sonra her alıcının iletim raporunu GET /messages/{id} ile kontrol edin. Dört durum vardır: pending, sent, delivered ve failed. failed ile biten parçaların tutarı refunded alanına eklenir ve bakiyenize döner. Henüz çıkmamış planlı gönderimi POST /messages/{id}/cancel ile iptal edin.
Doğrulama kodu (OTP) göndermek için de aynı yöntemi kullanın. Her kod ayrı doğrulama ücreti olmadan bir SMS sayılır; maliyetlerinizi hesaplamak için her ülkenin SMS başına fiyatını GET /messages/prices ile alabilirsiniz.
Uygun fiyatlı bir SMS API'de nelere bakmalıyım?
Fiyat listesindeki SMS başına fiyata değil, gerçekten ödediğiniz toplam tutara bakın. TODAY SMS'te aylık ücret yoktur, yalnızca gönderdiğiniz parçalar düşülür; başarısız parçalar ve hiç gelmeyen doğrulama kodları bakiyenize iade edilir.
Sonra, anahtar yönetimi ve limitlere bakın. Hesap başına bir API anahtarı alırsınız ve istediğiniz zaman yeni bir anahtar oluşturabilirsiniz, bu da eski anahtarı hemen engeller. Dakikada 300 isteğe kadar izin verilir, çoğu otomasyon için yeterlidir. Son olarak, ödemeye bakın. USDT, USDC ve BTC dahil 12 kripto yöntemiyle kart olmadan kredi ekleyebilirsiniz, böylece herhangi bir ülkeden hemen başlayabilirsiniz.
API anahtarını nasıl alırım?
Hesap oluşturun; ilk yüklemeniz bakiyenize geçince API anahtarı sayfasında anahtar oluşturabilirsiniz. Anahtar yalnızca oluşturulduğunda bir kez gösterilir, bu yüzden güvenli bir yerde saklayın. Her istekte Authorization: Bearer başlığıyla gönderin.
Anahtarınızın sızdığını düşünüyorsanız API anahtarı sayfasında yeni bir anahtar oluşturun. Eski anahtar hemen çalışmaz olur. Anahtarınıza sahip olan herkes bakiyenizle numara alabilir veya SMS gönderebilir; bu yüzden anahtarı asla tarayıcı koduna veya herkese açık bir depoya koymayın.
SMS API'yi bugün bağlayın
Kayıt tek bir token ile tamamlanır. İlk yüklemeniz bakiyenize geçince bir API anahtarı oluşturun, belgelerden bir örneği yapıştırın ve ilk isteğinizi gönderin.