Pilih prefiks yang didukung
Gunakan prefiks seluler individual terkini dari discovery. Endpoint ini ditujukan untuk exchange NANPA: NPA mengidentifikasi kode area, dan NXX mengidentifikasi exchange. Prefiks hanya kode area terlalu luas. Jangan mengirim ID tampilan berkelompok atau menyimpulkan dukungan untuk negara lain hanya karena prefiksnya memuat cukup digit.
Gunakan hitungan sebagai petunjuk
Baca response.count, dengan response.npa dan response.nxx mengidentifikasi exchange. Ini adalah snapshot layanan cakupan, bukan stok yang disimpan untuk akun Anda. Konfirmasikan nomor aktual, penawaran yang berlaku, dan persyaratan pendaftaran apa pun sebelum memesan. Hitungan yang berhasil tidak pernah mengotorisasi pembelian.
Bedakan stok nol dari lookup yang gagal
Hitungan nol yang berhasil berbeda dari error API. Periksa status.code dan status.msg serta status HTTP. Perlakukan waktu tunggu habis atau lookup yang gagal sebagai ketersediaan yang tidak diketahui dan coba lagi nanti dengan backoff.
Permintaan
Gunakan kredensial akun API Anda yang diaktifkan melalui HTTPS. Autentikasi Basic dan token bearer akun-API yang diaktifkan didukung; pembatasan akun berlaku.
GET dengan pengidentifikasi prefiks di jalur URL. Tidak ada parameter query atau body yang didokumentasikan.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
prefix_id | string | Ya | Salin ID prefiks individual dari respons discovery. Gunakan prefiks seluler NANPA yang didukung yang memuat kode area (NPA) dan exchange (NXX), bukan ID hanya-kode-area atau ringkasan berkelompok. Perlakukan pengidentifikasi tersebut sebagai opaque. |
Respons
Periksa status.code dalam body JSON serta status HTTP. response yang berhasil memiliki status.code 200 dan status.msg Results. response adalah objek, bukan daftar: count adalah snapshot inventaris bilangan bulat; npa dan nxx adalah string tiga karakter. status.results tidak ada untuk objek asosiatif ini. Hitungan 0 berarti lookup cakupan tidak menemukan exchange yang cocok atau mengembalikan stok nol; hal itu tidak membuktikan bahwa semua pemasok atau rute discovery lain tidak memiliki nomor.
Bentuk respons ilustratif; bukan data akun langsung maupun penawaran saat ini.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Error
- 404: Penyedia dinonaktifkan: cakupan inventaris seluler tidak tersedia di layanan ini.
- 404: ID prefiks tidak valid: dapatkan ID prefiks individual terkini dari discovery.
- 404: Prefiks tidak valid: prefiks yang tersimpan tidak memuat cukup digit untuk lookup NPA/NXX.
- 500: Cakupan inventaris gagal: lookup upstream tidak mengembalikan hasil cakupan yang berhasil. Coba lagi nanti dengan backoff; kegagalan bukanlah hitungan stok nol.
Ketersediaan dan efek samping
- Operasi ini memeriksa inventaris dan tidak melakukan pemesanan, tidak mereservasi nomor, dan tidak mendebit jumlah pembelian.
- Stok dapat berubah seketika. Hitungan cakupan tidak disesuaikan untuk menjanjikan keterbelian khusus akun atau panjang yang sama dengan respons pencarian nomor berikutnya.
- Lookup menghubungi layanan cakupan dan dapat memakan waktu. Jangan melakukan polling berulang pada setiap prefiks, atau memperlakukan waktu tunggu habis/error sebagai stok nol yang berhasil.