Temukan nomor seluler yang tersedia

Pastikan inventaris seluler telah diaktifkan

Gunakan pencarian ini hanya setelah inventaris nomor seluler diaktifkan untuk akun pelanggan Anda. Dapatkan prefiks seluler individual terkini melalui alur kerja penemuan (discovery) akun. Jalur yang didukung meminta inventaris nirkabel untuk prefiks tersebut. Jalur ini tidak bergantung pada catatan metadata perutean wireline yang cocok. Hubungi dukungan jika Anda tidak yakin apakah akun atau prefiks Anda telah diaktifkan.

Rute legacy saat ini tidak secara andal menolak setiap permintaan yang tidak memenuhi syarat. Akun yang inventaris selulernya belum diaktifkan dapat menerima inventaris biasa sementara respons tetap menyatakan info.is_mobile: 1. Prefiks bebas pulsa juga dapat mencapai cabang inventaris bebas pulsa dengan label tersebut. Jangan gunakan label ini saja untuk mengidentifikasi layanan seluler, dan jangan kirim prefiks biasa atau bebas pulsa ke endpoint ini. Gunakan katalog seluler yang telah dikonfirmasi dan alur kerja yang diaktifkan untuk akun tersebut.

Jaga setiap nomor tetap bersama pilihan harganya sendiri

Untuk setiap kandidat, simpan number, info.uuid dan daftar price dari entri yang sama secara bersamaan. Respons juga berisi metadata prefiks/area/negara, ketentuan kontrak, dan pembatasan registrasi. Kandidat diurutkan berdasarkan harga bulanan dari opsi harga pertamanya, secara menaik; tidak ada urutan stabil yang dijamin untuk harga yang sama. Jangan ganti ID nomor yang dikembalikan dengan ID area atau prefiks, dan jangan pasangkan dengan ID harga kandidat lain.

Respons lengkap dapat mencakup metadata dan bidang harga tambahan. Nilai features, nilai channel, dan restrictions yang dikembalikan menggambarkan kandidat; itu bukan jaminan bahwa panggilan, SMS, MMS, atau faks sudah dapat digunakan. Izin akun, registrasi, dan paket layanan yang dipilih tetap berlaku. Jangan perlakukan placeholder pada contoh sebagai ID atau harga yang valid.

Gunakan jumlah positif yang kecil

Mulailah dengan jumlah 1. Permintaan penyedia yang normal menormalkan jumlah nonpositif menjadi 1 dan membatasi nilai upstream pada 300, tetapi penanganan hasil selanjutnya tetap menggunakan input asli. Karena itu, jumlah nol dapat meminta inventaris upstream dan tidak mengembalikan kandidat apa pun. Cabang legacy lainnya tidak secara konsisten menegakkan jumlah hasil yang diminta. Jangan andalkan satu batas maksimum universal, dan jangan kirim nilai negatif, pecahan, atau nonnumerik. Tidak ada filter pencarian publik atau parameter body ID harga yang didukung yang didokumentasikan untuk rute ini.

Bedakan stok yang tidak ada dari kegagalan pencarian

Respons 404 dapat berarti inventaris tidak tersedia, layanan dinonaktifkan, pencarian pemasok gagal, atau catatan katalog tidak valid. Perlakukan timeout atau kegagalan penyedia sebagai ketersediaan yang tidak diketahui, bukan sebagai stok nol yang terkonfirmasi. Segarkan pilihan dan coba lagi dengan backoff bila sesuai. Hindari melakukan polling setiap exchange secara berulang. Endpoint hitung inventaris seluler yang terpisah hanyalah petunjuk snapshot dan tidak harus cocok dengan panjang daftar kandidat akun ini.

Periksa ulang sebelum membeli

Pencarian tidak memesan stok. Cabang yang ditinjau berupaya mengecualikan nomor yang sudah dibeli, tetapi pencarian reservasi lokal yang gagal dapat membiarkan kandidat semacam itu tetap ada dalam hasil. Ketersediaan, kepemilikan, harga yang disetujui, dan registrasi harus diperiksa oleh alur kerja pembelian. Gunakan pilihan baru dengan permintaan pembelian yang dijaga, dan rekonsiliasikan inventaris akun setelah hasil pembelian yang tidak pasti sebelum mencoba lagi. Jangan pernah membeli hanya karena suatu kandidat dikembalikan.

Permintaan

Gunakan akun API yang diaktifkan melalui HTTPS dari alamat IP sumber yang diizinkan. Inventaris seluler juga harus diaktifkan untuk akun pelanggan; autentikasi API saja tidak mengaktifkannya.

GET dengan pengenal prefiks individual terkini dan jumlah bilangan bulat positif di jalur URL. Jumlah default adalah 1 jika dihilangkan. Gunakan contoh dengan 1; rute ini tidak secara konsisten memvalidasi atau menegakkan batas hasil universal.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"

Respons

Periksa status.code dan status.msg di body JSON serta status HTTP. Jika berhasil, response adalah daftar kandidat nomor, status.msg adalah Results: diikuti jumlah yang dikembalikan, dan status.results adalah panjang daftar yang diserialisasi. Harga kandidat bersifat spesifik per akun. Contoh ringkas yang ilustratif menggunakan placeholder, bukan inventaris nyata atau penawaran tarif. Nomor berisi kode negara tanpa tanda plus; pengenal adalah string opak.

Bentuk respons ilustratif; bukan data akun langsung atau penawaran harga terkini.

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

Kesalahan

• 404: ID prefiks, negara, atau area tidak valid: segarkan pilihan prefiks seluler individual.
• 404: Tidak ada nomor yang ditemukan: dapat berarti tidak ada stok yang dapat digunakan, layanan dinonaktifkan, pencarian penyedia gagal, pilihan tidak didukung, atau keterbatasan akun. Ini bukan bukti hitungan inventaris nol yang otoritatif.

Ketersediaan dan efek samping

• Pencarian tidak menyewa atau memesan nomor, dan jalur yang ditinjau tidak mendebit jumlah pembelian. Pencarian ini menghubungi penyedia inventaris dan dapat memakan waktu.
• Pencarian yang berhasil menulis entri cache nomor dan harga yang terkait akun serta log kueri. Mengulangi pencarian bukanlah reservasi, penguncian harga, atau pembelian.
• Harga, ketentuan, pembatasan, dan kemampuan yang dikembalikan harus ditinjau untuk akun dan nomor yang dipilih. Label fitur tidak menetapkan aktivasi, persetujuan pengiriman pesan, atau fungsionalitas layanan yang telah diuji.