Dokumentasi REST API
API REST pencarian perutean LRN
Cari nomor perutean dan informasi operator yang tersedia untuk nomor telepon Amerika Utara dengan harga tetap.
Pilih API dan kredensial secara bersamaan
Akun dengan profil Pengembang & Otomatisasi, Bisnis, dan Penyedia komunikasi yang telah disetujui dapat mengintegrasikan layanan yang diaktifkan. Pengembang individu tidak perlu berpura-pura menjadi perusahaan. SMS/MMS dari aplikasi memerlukan persetujuan pengiriman dan registrasi yang berlaku. Layanan Pribadi & Keluarga tidak memiliki API pengiriman pesan yang dapat diakses pelanggan.
| Keluarga API | URL dasar | Autentikasi dan hasil |
|---|---|---|
| Komunikasi v3 | https://api.multitel.net/v3 | Kredensial Basic yang disetujui; token yang disediakan dan memenuhi syarat hanya untuk operasi yang mendukungnya. JSON status dan response. |
| Registrasi darurat | https://api.multi.tel/emergency | Kredensial Basic yang disetujui atau akses bearer yang disediakan secara khusus. JSON code, message, dan data. |
| Integrasi REST portal | Host dan operasi yang ditampilkan dalam referensi pengembang akun Anda | Gunakan kredensial, cakupan izin (scope), dan skema yang didokumentasikan untuk operasi tersebut. Permintaan sesi browser menggunakan antarmuka yang terpisah. |
Atur MULTITEL_API_USERNAME dan MULTITEL_API_PASSWORD melalui konfigurasi rahasia server Anda sebelum menggunakan contoh. Jangan pernah menanamkannya di JavaScript browser publik, URL, atau kontrol sumber. Kredensial khusus dikelola di pengaturan Integrasi API.
Cari sebuah nomor
GET /v3/lrn/{number} menerima nomor tujuan pada path. Nomor asal opsional dapat disertakan sebagai /v3/lrn/{number}/{ani} untuk informasi yang bergantung pada asal. Tuliskan nomor telepon Amerika Utara hanya dengan angka, termasuk kode negara bila berlaku; contoh menggunakan nomor fiktif yang dicadangkan.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123"curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123/12025550124"Menjalankan pencarian dengan kredensial yang valid dikenai biaya. Tarifnya adalah US$0,00025 per pencarian: US$0,25 per 1.000 atau US$250 per satu juta. Tidak ada diskon volume. Ini adalah pencarian informasi perutean; pencarian ini tidak melakukan panggilan telepon.
Membaca hasilnya
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ported": 0,
"ocn": "",
"lata": "",
"rc": "",
"cost": "$0.00025"
}
}Contoh rekaan ini hanya menunjukkan bentuk respons; ini bukan hasil perutean yang terukur. Periksa status.code sebelum menggunakan response. Kolom cost adalah string berawalan mata uang, bukan angka JSON.
| Kolom | Arti |
|---|---|
lrn | Location Routing Number yang digunakan untuk mengidentifikasi tujuan perutean. |
ported | Indikator portabilitas yang diberikan oleh pencarian ini: biasanya 0 atau 1. Jangan gunakan sebagai bukti kepemilikan atau kelayakan layanan. |
ocn | Operating Company Number, bila tersedia. |
lata | Local Access and Transport Area, bila tersedia. |
rc | Rate center, bila tersedia. |
city, state, lec, lectype, jurisdiction, local | Detail tambahan terkait lokasi, operator, atau asal bila tersedia. Detail ini mungkin tidak ada atau kosong. |
Jangan mewajibkan semua kolom perutean tersedia. Khususnya, hasil untuk nomor bebas pulsa dapat tidak memuat detail rate center lokal dan kode operator. LRN yang dikembalikan bukan jaminan bahwa nomor dapat dihubungi saat itu juga, dan bukan uji kualitas panggilan.
Gunakan pencarian dalam alur kerja perutean Anda
- Validasi dan normalisasi nomor yang diminta sebelum mengirimkannya.
- Periksa status HTTP dan status aplikasi. Simpan catatan yang telah disamarkan berisi nomor, waktu, dan hasil untuk pemecahan masalah.
- Gunakan hanya kolom yang relevan dengan aturan perutean Anda dan tangani nilai yang tidak ada secara eksplisit.
- Batasi percobaan ulang setelah respons yang tidak pasti. Mengulangi pencarian dapat menimbulkan biaya lagi; endpoint ini tidak memiliki kunci idempotensi yang terdokumentasi.
Lihat produk LRN dan harga flat. Path OpenAPI publik menyertakan segmen ANI; implementasi LRN yang diterapkan juga menerima permintaan yang lebih singkat tanpa ANI. lrninfo adalah operasi terpisah dan tidak boleh menggantikan endpoint ini.
Menangani kesalahan dan percobaan ulang
- Kegagalan autentikasi atau izin
- Periksa status aktif kredensial API, layanan yang diizinkan, dan pembatasan IP sumber. Cookie sesi portal bukan kredensial integrasi.
- Kredit tidak mencukupi atau persetujuan belum terpenuhi
- Selesaikan masalah saldo akun, persetujuan pengiriman, atau persyaratan dokumen sebelum mengulangi operasi.
- Tidak ada hasil
- Tangani inventaris kosong atau nama pemanggil yang tidak ditemukan sebagai hasil yang wajar. Jangan berasumsi bahwa nomor yang sintaksnya valid memiliki semua layanan.
- Waktu tunggu jaringan habis atau layanan gagal
- Gunakan percobaan ulang terbatas dengan backoff untuk operasi baca. Untuk pembelian, pengiriman, atau registrasi, periksa dahulu status operasinya; mengulangi permintaan yang sudah diterima dapat menggandakan tindakan yang ditagih.
Dukungan idempotensi bergantung pada masing-masing keluarga API. Emergency API mendukung kunci percobaan ulang; hal itu tidak membuat permintaan v3 sembarang menjadi idempoten. Simpan stempel waktu, ID yang dikembalikan, dan respons yang telah disamarkan untuk dukungan.
Lanjutkan dengan referensi akun Anda
Referensi setelah masuk menyaring operasi berdasarkan izin dan layanan yang aktif pada akun Anda. Gunakan host, jenis kredensial, kolom permintaan, dan skema respons persis seperti yang tercantum di sana. Konsol dapat menjalankan operasi langsung, termasuk pembelian dan pengiriman pesan.