Her parametre, canlı yanıt ve belgelenen her başarı/hata tek ekranda.
getNumber
V1
GET / POST
Bir hizmet/ülke için telefon numarası satın alın.
Virgülle ayrılmış değerleri kabul eder — Tiger SMS'e özel bir özellik.
Kabul edilir ama şu an göz ardı edilir (doğrulama kuralı yok, sessizce atılır, hata yok): operator, phoneException, minPrice.
Otomatik ülke tespiti (örn. `country=any`) desteklenmez: `country` sayısal bir ülke kodu olmalıdır — sayısal olmayan veya bilinmeyen bir ülke BAD_COUNTRY döndürür.
Bu yöntemde virgülle ayrılmış listeler yalnızca providerIds/exceptProviderIds için desteklenir. Buradaki üst düzey `service`/`country` alanları virgüllü liste kabul etmez — bu özellik yakında yalnızca fiyat sorgulama yöntemlerinde (getPrices/getFreePrices/getPricesV2/getPricesV3) gelecek.
getNumberTest tam olarak getNumber gibi davranır, ancak activationType/testParams değerlerini açıkça geçmenin belgelenmiş yoludur.
Bu gerçek bir istektir — başarılı bir çağrı bakiyenizden düşebilir veya canlı bir aktivasyonu değiştirebilir.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
setStatus
V1
GET / POST
Bir aktivasyonun durumunu değiştirin (ready/retry/cancel/complete).
Yanıt her zaman düz bir durum token'ıdır, asla bir JSON zarfı değildir — JSON'a ihtiyacınız varsa setStatusV2 kullanın.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getStatus
V1
GET / POST
Bir aktivasyonun durumunu/kodunu yoklayın (poll).
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getPrices
V1
GET / POST
Ülke ve hizmete göre düz price/count haritası.
Virgülle ayrılmış değerleri kabul eder — Tiger SMS'e özel bir özellik.
Bilinmeyen veya kaldırılmış bir service/country kodu BAD_SERVICE/BAD_COUNTRY döndürür. Çift için sunulan varyasyonu bulunmayan geçerli bir kod yine de boş sonuç verir (anahtar atlanır).
Virgülle ayrılmış listeler (etkinleştirildiğinde): her belirteç tek bir değerle aynı şekilde doğrulanır; listelenen kodların hiçbiri yoksa BAD_SERVICE/BAD_COUNTRY döndürülür.
The recommended maxPrice for getNumber is NOT cost but saleAveragePrice (see getFreePrices/getPricesV2, getOffers prices.default/avg, getPricesV3): purchases are captured at the actual (usually lower) price while avoiding NO_NUMBERS/WRONG_MAX_PRICE when the cheapest bucket dries up. Your personal contract price, when set, still overrides cost.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Virgülle ayrılmış değerleri kabul eder — Tiger SMS'e özel bir özellik.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getPricesV2
V2
GET / POST
getFreePrices'ın takma adı (alias).
Virgülle ayrılmış değerleri kabul eder — Tiger SMS'e özel bir özellik.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getBalance
V1
GET / POST
Güncel hesap bakiyesi.
API anahtarı eksik veya geçersiz olduğunda, bu yöntem hiç çalışmadan önce BAD_KEY (HTTP 401) döndürülür — bu, yalnızca bu yönteme değil her yönteme uygulanır.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getServiceNumbersCount
V1
GET / POST
Bir hizmet/ülke için kullanılabilir numara sayısı.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getProviders
V1
GET / POST
Genel sağlayıcı listesi (id/name/numbers_count/delivery_percent/number_lifetime, fiyat yok).
With both service and country set, the list is filtered to providers that actually serve that pair's price buckets — coherent with getPricesV3 and getNumber providerIds.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getNumberV2
V2Yeni
GET / POSTapi_get_number_v2_enabled
Purchase a phone number, full typed JSON success/error envelope.
Virgülle ayrılmış değerleri kabul eder — Tiger SMS'e özel bir özellik.
Bu gerçek bir istektir — başarılı bir çağrı bakiyenizden düşebilir veya canlı bir aktivasyonu değiştirebilir.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getStatusV2
V2Yeni
GET / POSTapi_get_status_v2_enabled
Activation status as JSON (verificationType + sms block).
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getPricesV3
V3Yeni
GET / POSTapi_prices_v3_enabled
Price/count map with a per-provider price breakdown.
Virgülle ayrılmış değerleri kabul eder — Tiger SMS'e özel bir özellik.
Bu ailedeki diğer tüm JSON yöntemlerinin aksine, buradaki beklenmeyen bir dahili hata, bir JSON gövdesi yerine düz metin BAD_ACTION yanıtını döndürür — bu bilinçli bir tercihtir; böylece JSON ayrıştıran bir istemci asla yarım biçimlenmiş bir JSON gövdesi almaz.
Virgülle ayrılmış listeler (yakında): service veya country alanlarından biri virgül içerdiğinde devreye girer; her bir öğe tek bir değerle aynı şekilde doğrulanır ve her liste en fazla 50 öğe, toplamda 100 country×service kombinasyonu ile sınırlıdır.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getOffers
V3Yeni
GET / POSTapi_offers_enabled
Combined price+stock showcase: default/avg/retail/min price, counts and the full price-bucket map, by service and country.
Requires the same price-bucket data as getFreePrices/getPricesV3 — when that data isn't available for this account, this method returns an empty `data: {}` rather than falling back to catalog prices.
There is no `counts.physical` field: our provider module does not currently expose a physical stock figure separate from `counts.total`, and this method does not invent one. It may be added later if that data becomes available.
Never exposes providers, cost, or purchase price — none of those exist in this response by design.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getServicesList
V1Yeni
GET / POSTapi_catalog_enabled
Catalog of services (code + name), optionally localized.
Bu yöntemin tek başarısızlık durumu, boş bir services listesi içeren bir 200 success yanıtıdır — ayrılmış bir hata yanıtı yoktur.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getCountries
V1Yeni
GET / POSTapi_catalog_enabled
Catalog of countries (id + localized names).
Beklenmeyen bir hata durumunda hata yanıtı yerine boş bir JSON dizisi `[]` döner.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
getActiveActivations
V1Yeni
GET / POSTapi_active_activations_enabled
List of currently active activations for the key owner.
Beklenmeyen bir hatada asla hata vermez (getServicesList/getCountries ile aynı felsefe) — status yine de "success" kalırken boş bir `data: []` listesine geriler.
activationStatus değerleri: 1=WAIT_CODE, 2=WAIT_ACCEPTING, 3=WAIT_NEXT_SMS, 6=OK, 7=REFUND, 8=CANCEL — bu numaralandırma bize özgüdür ve kullandığınız diğer SMS API'lerinden farklı olabilir.
Bu isteği kendi API anahtarınızla çalıştırmak için oturum açın.
Giriş yapKayıt ol
Belgelenen tüm yanıtlar
Gelen SMS Webhook
getStatus/getStatusV2'yi sürekli yoklamak yerine, gelen SMS'i ulaşır ulaşmaz kendi HTTPS uç noktanıza gönderilmiş olarak alın.
Yük (payload) örneği
POSTapplication/json
Alınan her SMS segmenti için, kayıtlı URL'nize gönderilen bir POST. Yalnızca HTTP 200 yanıtı kabul edilmiş sayılır; yönlendirmeler takip edilmez.
activationId Aktivasyon kimliği, getStatus/getStatusV2 tarafından kullanılan `id` parametresiyle aynı değer.
service Numaranın satın alındığı sms_activate tarzı hizmet kodu.
code SMS'ten çıkarılan kod segmenti, getStatus'un iki nokta üst üsteden (colon) sonra döndürdüğü değerle aynıdır.
text Sağlayıcı bir metin sağladıysa tam SMS metni, aksi halde `code` ile aynıdır.
country Sayısal ülke kodu (sms_activate_code), veya aktivasyonun ülkesi için hiçbiri ayarlanmamışsa null.
receivedAt SMS'in alındığı andaki ISO 8601 zaman damgası (UTC).
İmza doğrulama
X-SignatureHMAC-SHA256
Ham JSON istek gövdesinin, webhook gizli anahtarınızla anahtarlanmış Hex HMAC-SHA256'sı. Yükü (payload) güvenmeden önce kendi tarafınızda aynı şekilde yeniden hesaplayın ve karşılaştırın.
Yeniden deneme (retry) politikası
Toplamda en fazla 3 deneme: denemeler arasında 5sn, sonra 30sn, sonra 120sn. Her deneme 10sn sonra zaman aşımına uğrar. Her deneme başarısız olursa olay sessizce düşürülür — bunun için bir dead-letter kuyruğu veya uyarı sistemi yoktur.
Uç noktanız genel bir HTTPS URL'si olmalıdır; özel, loopback, link-local ve diğer dahili adresler hem URL'yi kaydederken hem de her teslimat denemesinde reddedilir (rebinding'i önlemek için DNS her istekte yeniden çözümlenir ve sabitlenir).
İmzalama gizli anahtarı, bir kez otomatik olarak oluşturulur ve hesap başına saklanır; destek ekibi değiştirene kadar her teslimat için aynı gizli anahtardır.
