Bangun dan uji permintaan API dengan kunci Anda sendiri
Setiap metode publik telah didokumentasikan dan siap dijalankan — pilih satu, isi parameter sebenarnya, dan panggil secara langsung menggunakan akun Anda sendiri.
Masuk untuk menjalankan permintaan langsung dengan kunci API Anda sendiri — setiap metode di bawah tetap terdokumentasi lengkap meskipun sebagai tamu.
Lihat spesifikasi OpenAPI·Ekspor koleksi Postman
Kunci placeholder digunakan di mana-mana pada halaman ini — masuk untuk menyalin permintaan dan cuplikan dengan kunci API asli Anda sendiri.
Pilih metode untuk memulai
Setiap parameter, respons langsung, dan setiap keberhasilan/kesalahan yang terdokumentasi ada dalam satu layar.
getNumber
V1
GET / POST
Membeli nomor telepon untuk suatu layanan/negara.
Menerima nilai yang dipisahkan koma — fitur eksklusif Tiger SMS.
Diterima tetapi saat ini diabaikan (tidak ada aturan validasi, dibuang secara diam-diam, tanpa error): operator, phoneException, minPrice.
Deteksi country otomatis (mis. `country=any`) tidak didukung: `country` harus berupa kode negara numerik — country non-numerik atau tidak dikenal mengembalikan BAD_COUNTRY.
Daftar yang dipisahkan koma pada metode ini hanya didukung untuk providerIds/exceptProviderIds. `service`/`country` tingkat atas tidak menerima daftar koma di sini — kemampuan itu segera hadir hanya pada metode pencarian harga (getPrices/getFreePrices/getPricesV2/getPricesV3).
getNumberTest berperilaku persis seperti getNumber, tetapi merupakan cara yang didokumentasikan untuk memberikan activationType/testParams secara eksplisit.
Ini adalah permintaan sungguhan — panggilan yang berhasil dapat memotong saldo Anda atau mengubah aktivasi yang sedang berjalan.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
setStatus
V1
GET / POST
Mengubah status suatu aktivasi (ready/retry/cancel/complete).
Respons selalu berupa token status polos, tidak pernah respons JSON — gunakan setStatusV2 jika Anda membutuhkan JSON.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getStatus
V1
GET / POST
Melakukan polling status/kode suatu aktivasi.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getPrices
V1
GET / POST
Peta harga/jumlah datar berdasarkan negara dan layanan.
Menerima nilai yang dipisahkan koma — fitur eksklusif Tiger SMS.
Kode service/country yang tidak dikenal atau telah dihapus mengembalikan BAD_SERVICE/BAD_COUNTRY. Kode valid yang tidak memiliki variasi yang ditawarkan untuk pasangan tersebut tetap menghasilkan empty result (key dihilangkan).
Daftar yang dipisahkan koma (jika diaktifkan): setiap token divalidasi dengan cara yang sama seperti nilai tunggal; jika tidak ada satu pun kode dalam daftar yang ada, BAD_SERVICE/BAD_COUNTRY dikembalikan.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getFreePrices
V2
GET / POST
Peta detail price-bucket (price => count, flag multi-SMS) berdasarkan negara/layanan.
Menerima nilai yang dipisahkan koma — fitur eksklusif Tiger SMS.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getPricesV2
V2
GET / POST
Alias dari getFreePrices.
Menerima nilai yang dipisahkan koma — fitur eksklusif Tiger SMS.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getBalance
V1
GET / POST
Saldo akun saat ini.
BAD_KEY (HTTP 401) dikembalikan sebelum metode ini dijalankan sama sekali, kapan pun kunci API tidak ada atau tidak valid — ini berlaku untuk setiap metode, bukan hanya yang ini.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getServiceNumbersCount
V1
GET / POST
Jumlah nomor yang tersedia untuk suatu layanan/negara.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getProviders
V1
GET / POST
Daftar penyedia publik (id/name/numbers_count/delivery_percent/number_lifetime, tanpa harga).
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getNumberV2
V2Baru
GET / POSTapi_get_number_v2_enabled
Purchase a phone number, full typed JSON success/error envelope.
Menerima nilai yang dipisahkan koma — fitur eksklusif Tiger SMS.
Ini adalah permintaan sungguhan — panggilan yang berhasil dapat memotong saldo Anda atau mengubah aktivasi yang sedang berjalan.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getStatusV2
V2Baru
GET / POSTapi_get_status_v2_enabled
Activation status as JSON (verificationType + sms block).
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getPricesV3
V3Baru
GET / POSTapi_prices_v3_enabled
Price/count map with a per-provider price breakdown.
Menerima nilai yang dipisahkan koma — fitur eksklusif Tiger SMS.
Tidak seperti setiap metode JSON lain dalam keluarga ini, error internal tak terduga di sini mengembalikan respons BAD_ACTION teks polos alih-alih body JSON — ini disengaja, sehingga klien yang mem-parsing JSON tidak pernah menerima body JSON yang setengah jadi.
Daftar yang dipisahkan koma (segera hadir): akan terpicu ketika service atau country mengandung koma; setiap token divalidasi dengan cara yang sama seperti nilai tunggal, dan setiap daftar dibatasi hingga 50 item dengan total 100 kombinasi country×service.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getOffers
V3Baru
GET / POSTapi_offers_enabled
Combined price+stock showcase: default/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.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getServicesList
V1Baru
GET / POSTapi_catalog_enabled
Catalog of services (code + name), optionally localized.
Satu-satunya mode kegagalan metode ini adalah respons sukses 200 dengan daftar services kosong — tidak ada respons error khusus.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getCountries
V1Baru
GET / POSTapi_catalog_enabled
Catalog of countries (id + localized names).
Beralih ke array JSON kosong `[]` saat terjadi kegagalan tak terduga, bukan respons error.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
getActiveActivations
V1Baru
GET / POSTapi_active_activations_enabled
List of currently active activations for the key owner.
Tidak pernah menghasilkan error saat kegagalan tak terduga (filosofi yang sama seperti getServicesList/getCountries) — beralih ke daftar `data: []` kosong dengan status tetap "success".
Nilai activationStatus: 1=WAIT_CODE, 2=WAIT_ACCEPTING, 3=WAIT_NEXT_SMS, 6=OK, 7=REFUND, 8=CANCEL — penomoran ini khusus milik kami dan mungkin berbeda dari API SMS lain yang pernah Anda gunakan.
Masuk untuk menjalankan permintaan ini dengan kunci API Anda sendiri.
MasukPendaftaran
Semua respons yang terdokumentasi
Webhook SMS Masuk
Dapatkan SMS masuk yang dikirim langsung ke endpoint HTTPS Anda sendiri segera setelah tiba, alih-alih melakukan polling getStatus/getStatusV2.
Contoh payload
POSTapplication/json
Satu POST untuk setiap segmen SMS yang diterima, dikirim ke URL yang Anda daftarkan. Hanya respons HTTP 200 yang dihitung sebagai diterima; redirect tidak diikuti.
activationId ID aktivasi, nilai yang sama dengan parameter `id` yang digunakan oleh getStatus/getStatusV2.
service Kode layanan bergaya sms_activate tempat nomor tersebut dibeli.
code Segmen kode yang diekstrak dari SMS, nilai yang sama dengan yang dikembalikan getStatus setelah tanda titik dua.
text Teks SMS lengkap ketika penyedia menyediakannya, jika tidak identik dengan `code`.
country Kode negara numerik (sms_activate_code), atau null jika negara aktivasi belum diatur.
receivedAt Timestamp ISO 8601 (UTC) saat SMS diterima.
Verifikasi tanda tangan
X-SignatureHMAC-SHA256
HMAC-SHA256 heksadesimal dari body permintaan JSON mentah, menggunakan kunci webhook secret Anda. Hitung ulang dengan cara yang sama di sisi Anda dan bandingkan sebelum mempercayai payload.
Kebijakan percobaan ulang
Maksimal 3 kali percobaan: jeda 5 detik, lalu 30 detik, lalu 120 detik di antara percobaan. Setiap percobaan timeout setelah 10 detik. Jika semua percobaan gagal, event akan dibuang secara diam-diam — tidak ada dead-letter queue atau alerting.
Endpoint Anda harus berupa URL HTTPS publik; alamat private, loopback, link-local, dan alamat internal lainnya akan ditolak baik saat Anda menyimpan URL maupun pada setiap percobaan pengiriman (DNS diselesaikan ulang dan dipin per permintaan untuk mencegah rebinding).
Signing secret dibuat otomatis sekali dan disimpan per akun; secret yang sama digunakan untuk setiap pengiriman hingga tim support mengubahnya.
