- Ana sayfa
- API
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.
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.
| Yöntem ve yol | Ne yapar |
|---|---|
GET/ | USD cinsinden bakiyeniz |
GET/ | En düşük fiyat ve ülke sayısıyla tüm servisler |
GET/ | Bir servis için tek numaranın her ülkedeki fiyatı |
POST/ | Bir servis ve ülke için numara alır. Fiyat bakiyenizden düşülür |
GET/ | Numaranın durumu ve şu ana kadar gelen tüm kodlar |
POST/ | Kod gelmeden iptal eder. Ücret bakiyenize geri döner |
API'yi hangi sırayla çağırmalıyım?
- 1
Numara alın service ve country ile POST /numbers gönderin. id ve number değerlerini kaydedin.
- 2
Numarayı girin Numarayı, kodu gönderecek servise yazın.
- 3
Kodu kontrol edin codes listesi boş olmayana kadar 5 saniyede bir GET /numbers/{id} çağırın.
- 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/v1Authorization: Bearer <API_KEY>İstek alanları
| Alan | Kullanıldığı yer | Değer |
|---|---|---|
service | POST /numbers, GET /prices | /services listesindeki servis adı, ör. telegram |
country | POST /numbers | İki harfli ülke kodu, ör. gb |
Yanıt alanları ve durumlar
| Değer | Anlamı |
|---|---|
waiting | Numara açık, henüz kod gelmedi |
received | En az bir kod geldi. expires_at zamanına kadar başka kodlar da gelebilir |
refunded | 20 dakika içinde kod gelmedi. Ücret bakiyenize geri döndü |
canceled | Kod 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ı
unauthorized | API anahtarı eksik veya yanlış |
rate_limited | Bir dakikada 120 istekten fazla |
bad_service | Bilinmeyen servis adı |
bad_country | Ülke bu servis için mevcut değil |
low_balance | Bakiye fiyattan düşük |
unavailable | Şu anda uygun numara yok. Ücret alınmadı |
not_found | Hesabınızda bu id ile bir numara yok |
cannot_cancel | Kod 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"const api = (path, init = {}) => fetch("https://tomnumber.com/api/v1" + path, { ...init, headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" }, }).then((r) => r.json()); const n = await api("/numbers", { method: "POST", body: JSON.stringify({ service: "telegram", country: "gb" }) });console.log(n.number); // enter this number in the app let codes = [];while (!codes.length) { await new Promise((r) => setTimeout(r, 5000)); const s = await api("/numbers/" + n.id); if (s.status === "refunded" || s.status === "canceled") break; codes = s.codes;}console.log(codes.map((c) => c.code));import os, time, requests API = "https://tomnumber.com/api/v1"H = {"Authorization": "Bearer " + os.environ["API_KEY"]} n = requests.post(API + "/numbers", json={"service": "telegram", "country": "gb"}, headers=H).json()print(n["number"]) # enter this number in the app while True: time.sleep(5) s = requests.get(API + "/numbers/" + n["id"], headers=H).json() if s["codes"] or s["status"] in ("refunded", "canceled"): breakprint([c["code"] for c in s["codes"]])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.