İçeriğe geç
tomnumber

SMS onay API

Kendi yazılımınızdan numara alın ve kodları okuyun. API bakiyenizi kullanır. Fiyatlar ve 20 dakikalık iade kuralı sitedekiyle aynıdır.

API anahtarını hesabınızın içinde oluşturursunuz. API ile alınan numaraların ücreti aynı bakiyeden, sitedeki fiyatlarla düşülür.

Hesap oluşturAPI anahtarı

Numara başına en düşük $0.0018

Temel bilgiler

Numara başına en düşük fiyat
$0.0018
Kimlik doğrulama
API anahtarı
Biçim
HTTPS üzerinden JSON
İstek limiti
Dakikada 120 istek
İade
Sitedekiyle aynı

REST ve JSON

Altı istek yeterli: bakiye, servisler, fiyatlar, numara alma, durum ve iptal.

Hesabınızdan bir anahtar

Hesabınızdaki API anahtarı sayfasında bir anahtar oluşturun ve Authorization başlığında gönderin.

Sitedekiyle aynı fiyatlar

Numara fiyatları ve 20 dakikalık iade kuralı sitedekiyle aynıdır.

Hangi istekleri gönderebilirim?

Yollar temel URL'nin sonuna eklenir. Her istekte API anahtarınız gerekir.

Hangi istekleri gönderebilirim?
Yöntem ve yolNe yapar
GET/balanceUSD cinsinden bakiyeniz
GET/servicesEn düşük fiyat ve ülke sayısıyla tüm servisler
GET/prices?service=telegramBir servis için tek numaranın her ülkedeki fiyatı
POST/numbersBir servis ve ülke için numara alır. Fiyat bakiyenizden düşülür
GET/numbers/{id}Numaranın durumu ve şu ana kadar gelen tüm kodlar
POST/numbers/{id}/cancelKod gelmeden iptal eder. Ücret bakiyenize geri döner

API'yi hangi sırayla çağırmalıyım?

  1. 1

    Numara alın service ve country ile POST /numbers gönderin. id ve number değerlerini kaydedin.

  2. 2

    Numarayı girin Numarayı, kodu gönderecek servise yazın.

  3. 3

    Kodu kontrol edin codes listesi boş olmayana kadar 5 saniyede bir GET /numbers/{id} çağırın.

  4. 4

    Bitirin Kodu kullanın. Kod gelmeden numaraya ihtiyacınız kalmazsa iptal edin.

API anahtarını nasıl alırım?

Giriş yapın ve hesabınızda API anahtarı bölümünü açın. Bir anahtar oluşturup hemen kopyalayın, yalnızca bir kez gösterilir. Yeni anahtar oluşturduğunuzda eskisi devre dışı kalır.

API anahtarı

Temel URL nedir?

Her isteği bu adrese gönderin. Anahtarı Authorization başlığında (Bearer) ya da X-Api-Key başlığında ekleyin:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

İstek alanları

İstek alanları
AlanKullanıldığı yerDeğer
servicePOST /numbers, GET /prices/services listesindeki servis adı, ör. telegram
countryPOST /numbersİki harfli ülke kodu, ör. gb

Yanıt alanları ve durumlar

Yanıt alanları ve durumlar
DeğerAnlamı
waitingNumara açık, henüz kod gelmedi
receivedEn az bir kod geldi. expires_at zamanına kadar başka kodlar da gelebilir
refunded20 dakika içinde kod gelmedi. Ücret bakiyenize geri döndü
canceledKod gelmeden iptal ettiniz. Ücret bakiyenize geri döndü

Örnek yanıt

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

Hata kodları

Hata kodları
unauthorizedAPI anahtarı eksik veya yanlış
rate_limitedBir dakikada 120 istekten fazla
bad_serviceBilinmeyen servis adı
bad_countryÜlke bu servis için mevcut değil
low_balanceBakiye fiyattan düşük
unavailableŞu anda uygun numara yok. Ücret alınmadı
not_foundHesabınızda bu id ile bir numara yok
cannot_cancelKod zaten geldi ya da numara kapalı

Kod örnekleri

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

SMS onay API SSS

SMS onay API'si nedir?

Numara almayı ve kodları okumayı site yerine kendi programınızdan yapmanızı sağlayan bir yöntem.

API ek ücretli mi?

Hayır. Numaralar sitedekiyle aynı fiyattadır ve aynı bakiyeden ödenir.

Kaç istek gönderebilirim?

Anahtar başına dakikada en fazla 120 istek. 5 saniyede bir sorgulamak bu sınırın çok altında kalır.

API ile alınan numaralar da iade edilir mi?

Evet, aynı kuralla: 20 dakika içinde kod gelmezse ücret bakiyenize geri döner.

Anahtarı nerede oluştururum?

Hesabınızda API anahtarı bölümünde.

Diğer servisler için sanal numaralar