Mengintegrasikan API Pencarian Operator: Alur Kerja Operator Asli dan Tipe Saluran

Integrasikan API Pencarian Operator untuk memeriksa alokasi operator asli, tipe saluran, dan geografi penomoran menggunakan endpoint REST realtime dan pemrosesan file massal.

API Pencarian Operator menyediakan konteks operator asli dan alokasi nomor untuk manajemen data telekomunikasi. Saat organisasi meminta data nomor telepon menggunakan API ini, layanan akan mengembalikan data yang menunjukkan operator tempat blok nomor tersebut awalnya ditetapkan, beserta tipe saluran dan geografi alokasinya. Informasi ini mewakili penetapan administratif yang ditentukan oleh rencana penomoran, yang memberikan konteks telekomunikasi yang stabil untuk alur kerja perutean internal dan penilaian risiko. Karena mencerminkan alokasi awal dan bukan perutean jaringan pelanggan yang aktif, tim mengintegrasikan CarrierLookup untuk memeriksa parameter nomor dasar melalui endpoint tunggal realtime, kueri sinkron multi-item, atau file batch massal asinkron.

Data Alokasi Inti dan Atribut Tipe Saluran

Pengaturan penomoran telekomunikasi mengikuti standar internasional seperti ITU-T Recommendation E.164, yang mendefinisikan rencana penomoran global dengan kode negara dan nomor pelanggan. Dalam struktur ini, otoritas regulasi menetapkan blok nomor tertentu kepada operator jaringan. CarrierLookup mengekspos properti dasar ini melalui kemampuan Pencarian Operator Asli miliknya.

Skema respons mengatur konteks telekomunikasi ke dalam titik data yang berbeda:

• carrier: Penyedia komunikasi tempat rentang penomoran awalnya dialokasikan.
• underlying_carrier: Penyedia infrastruktur dasar yang terkait dengan rentang yang ditetapkan.
• number_type: Klasifikasi saluran, seperti penetapan seluler atau kabel.
• country_code: Awalan panggilan internasional yang sesuai dengan wilayah alokasi.
• region dan city: Wilayah geografis administratif yang ditetapkan dalam rencana penetapan penomoran.

Titik data ini menetapkan atribut rentang statis. Karena nomor mempertahankan definisi rentang awalnya terlepas dari aktivitas pelanggan, data ini bertindak sebagai referensi yang konsisten untuk pemfilteran, analisis telekomunikasi, dan pengorganisasian catatan internal.

Integrasi Pemeriksaan Tunggal dan Multi-Check Realtime

Mengintegrasikan pencarian realtime memungkinkan sistem backend untuk mengevaluasi nomor telepon secara sinkron selama alur kerja penerimaan atau peninjauan aplikasi. Permintaan melakukan autentikasi menggunakan header HTTP X-API-Key yang dikirimkan dari server aplikasi yang aman.

Alur Kerja Pemeriksaan Nomor Tunggal

Untuk memeriksa pengenal individu, kirimkan permintaan ke POST /api/v1/check. Payload memerlukan nomor telepon yang diformat dalam sintaks E.164 standar internasional, yang menampilkan tanda plus di depan, kode negara, dan digit pelanggan tanpa spasi atau tanda baca.

Setelah diproses, server mengembalikan respons JSON yang berisi code, msg, dan objek data datar. Payload data berisi service_type, identifier, carrier, underlying_carrier, number_type, country_code, region, dan city. Bidang alokasi opsional mungkin kembali kosong jika detail spesifik tidak tercantum untuk rentang tersebut, namun pencarian tetap terdaftar sebagai selesai.

Alur Kerja Pemeriksaan Multi-Check Sinkron

Untuk batch yang memerlukan evaluasi segera, organisasi memanggil POST /api/v1/batch-check. Endpoint ini memproses beberapa nomor E.164 secara sinkron dalam satu panggilan. Respons mengembalikan metrik eksekusi tingkat tinggi bersama dengan array terurut:

• service_type: Mengonfirmasi layanan pencarian yang dijalankan.
• total: Jumlah pengenal yang dikirimkan.
• succeeded: Jumlah item yang berhasil dievaluasi.
• failed: Jumlah item yang mengalami kegagalan pemrosesan.
• results: Kumpulan item terurut, masing-masing berisi identifier dan exists.

Dalam respons multi sinkron ini, nilai exists=false menunjukkan bahwa tidak ada catatan alokasi standar yang dikembalikan, bukan menegaskan bahwa saluran tersebut terputus atau salah format.

Alur Kerja Pemrosesan File Massal Asinkron

Saat memproses inventaris catatan telekomunikasi yang luas, tim menggunakan layanan asinkron carrier_batch. Alur kerja ini menangani pengiriman berbasis file tanpa membiarkan koneksi klien tetap terbuka.

Pengiriman dan Struktur Tugas

Kirimkan permintaan batch melalui POST /api/v1/bulk-tasks menggunakan data formulir multipart. Unggahan memerlukan file TXT atau CSV biasa yang berisi satu pengenal per baris, beserta parameter negara ISO yang ditentukan. Batas per-produk yang berlaku berlaku untuk ukuran tugas, dan pembaca dapat meninjau parameter operasional saat ini dalam dokumentasi API resmi.

Selama penyerapan, prapemrosesan otomatis meninjau konten daftar untuk memfilter duplikat, entri yang salah format, dan baris yang cocok dengan negara di luar target yang dipilih. Pemrosesan mengecualikan entri yang tidak sesuai ini dari penghitungan pencarian.

Siklus Hidup dan Pengambilan Tugas

Klien memantau kemajuan batch dengan menanyakan GET /api/v1/bulk-tasks/{id}. Jadwal polling harus mengikuti irama yang terukur, memeriksa tidak lebih sering dari sekali setiap 30 detik. Siklus hidup tugas beralih melalui tiga status formal:

• processing: File sedang dalam evaluasi sistem.
• failed: Tugas mengalami kesalahan eksekusi atau gagal memenuhi persyaratan asupan.
• success: Evaluasi rentang selesai dan output tersedia.

Ketika tugas selesai dengan success, endpoint menyediakan satu file CSV. Struktur output berisi tujuh header standar: identifier, carrier, underlying_carrier, number_type, country_code, region, dan city. Pengenal dalam file ini ditampilkan sebagai digit dengan kode negara, menghilangkan simbol plus.

Batas Operasional dan Spesifikasi Cakupan

Mengimplementasikan integrasi pencarian operator memerlukan penyelarasan arsitektur teknis dengan konkurensi sistem dan parameter geografis.

Cakupan geografis memiliki aturan regional yang berbeda. Pencarian nomor tunggal realtime mengakomodasi permintaan di seluruh Tiongkok daratan (+86), Hong Kong (+852), dan Makau (+853) untuk volume operasional yang moderat. Namun, file batch massal tidak menerima nomor dari ketiga wilayah ini. Status cakupan untuk Taiwan (+886) belum dikonfirmasi.

Untuk memverifikasi status akun sebelum melakukan pemeriksaan, kueri GET /api/v1/balance untuk mengambil saldo saat ini tanpa menggunakan pencarian. Selain itu, pengguna yang baru terdaftar dapat menghubungi dukungan untuk menerima 100 pemeriksaan gratis guna memvalidasi alur kerja integrasi mereka terhadap endpoint produksi.

FAQ

Bagaimana API menangani nomor yang telah dipindahkan antar jaringan?

CarrierLookup melaporkan operator tempat rentang penomoran awalnya ditetapkan oleh otoritas administratif. Dalam telekomunikasi, konsumen dapat beralih penyedia sambil tetap mempertahankan nomor mereka, seperti yang dijelaskan dalam Porting: Keeping Your Phone Number When You Change Providers. Akibatnya, bidang operator mencerminkan alokasi rentang historis ini alih-alih operator yang melayani saat ini, mempertahankan atribut struktural yang tidak berubah untuk analisis penomoran.

Apa yang membedakan multi-check realtime dari layanan batch massal?

Endpoint multi-check realtime POST /api/v1/batch-check mengevaluasi nomor secara sinkron, mengembalikan payload JSON segera dengan service_type, total, succeeded, failed, dan hasil terurut yang menunjukkan identifier dan boolean exists. Sebaliknya, layanan batch massal memproses daftar secara asinkron dari file CSV atau TXT yang dikirimkan. Setelah analisis latar belakang selesai, tugas massal menyediakan CSV yang dapat diunduh yang berisi kolom alokasi lengkap termasuk carrier, underlying_carrier, number_type, country_code, region, dan city.

Apakah bidang wilayah dan kota menunjukkan lokasi fisik perangkat?

Bidang wilayah dan kota menetapkan batas geografis dari alokasi rencana penomoran awal, yang sesuai dengan penetapan administratif pertukaran telepon. Nilai-nilai ini memberikan konteks teritorial untuk blok nomor pelanggan. Nilai-nilai ini mewakili penetapan penomoran statis alih-alih pemosisian perangkat seluler realtime, koneksi menara seluler langsung, atau keberadaan fisik pelanggan individu.

Pelajari Lebih Lanjut

Pilih informasi produk yang sesuai dengan langkah selanjutnya dalam alur kerja Anda.

• Lihat dokumentasi produk →
• Hubungi tim →