Kirim profil registrasi nomor

Siapkan profil tersimpan dan nomor

Gunakan alur kerja ini untuk mengaitkan profil registrasi tersimpan dengan nomor yang dibeli dan, untuk nomor berbasis operator yang didukung, meminta peninjauan registrasi. Ini bukan API aktivasi umum untuk semua penyedia nomor. Permintaan yang berhasil tidak membuktikan bahwa dokumen telah disetujui atau nomor sudah aktif.

Gunakan akun API MultiTEL yang telah diaktifkan melalui HTTPS dengan kredensial dan pembatasan IP yang telah dikonfigurasi. Profil yang belum dihapus dan nomor yang telah dibeli serta tidak dibatalkan harus sama-sama menjadi milik akun Anda.

Buat profil registrasi atau pilih yang sudah ada. Simpan uuid profil lokal dari create_document; get_document mengembalikan referensi lokal yang sama sebagai id.
Untuk pengajuan berbasis operator, profil memerlukan referensi identitas dan alamat yang telah disimpan. Lampirkan bukti dan dokumen pendukung yang diwajibkan melalui alur kerja masing-masing sebelum pengajuan.
Pastikan nomor dan profil memenuhi persyaratan negara dan nomor yang berlaku. Jangan menganggap profil tersimpan telah disetujui untuk semua nomor.

Ajukan pengaitan

curl --silent --show-error --request POST \
  --user "$API_USER:$API_PASSWORD" \
  --form-string document_uuid="$PROFILE_UUID" \
  --form-string service_description="Example customer support line" \
  https://api.multitel.net/v3/number_identity/12125550123

Jalur URL berisi nomor telepon yang dibeli, bukan UUID nomor tersebut, ekstensi PBX, atau ID identitas. Penangan menghapus karakter selain digit dari nomor. Gunakan nomor internasional lengkap beserta kode negara. Contoh ini fiktif dan harus diganti dengan nomor Anda sendiri serta referensi profil lokal yang telah disimpan.

Kolom pengajuan registrasi
Kolom	Wajib	Arti
`document_uuid`	Ya	uuid profil lokal tersimpan yang persis sama. Jangan menggantinya dengan identity_id atau address_id jarak jauh yang disamarkan, ID unggahan, atau nilai registration_details_id yang dikembalikan.
`service_description`	Tidak	Deskripsi layanan yang akan digunakan, yang diteruskan untuk verifikasi berbasis operator. Spasi di awal dan akhir dihapus.
`onetime_files`	Bergantung pada alur kerja	Larik yang diterima untuk dokumen sekali pakai operator. Penangan saat ini menghapus spasi di awal dan akhir string lalu meneruskannya tanpa mencari data yang dirujuk oleh referensi unggahan lokal. Kompatibilitas dengan ID tersamar yang dikembalikan oleh create_encrypt_files belum dipastikan; lihat batasan dokumen sekali pakai di bawah sebelum menggunakan kolom ini.

Untuk permintaan multipart, larik menggunakan kolom onetime_files[] yang diulang. Permintaan JSON juga diterima dengan Content-Type: application/json; propertinya digabungkan ke dalam muatan formulir. number dapat diberikan dalam muatan jika nomor pada jalur URL tidak disertakan. Sebaiknya gunakan jalur eksplisit yang ditampilkan di atas untuk menghindari ambiguitas.

Bedakan pengaitan dengan persetujuan

Baca hasil HTTP dan status.code pada JSON. Kesalahan JSON dapat diterima bersama HTTP 200. Keberhasilan berbasis operator melaporkan Address verification task created; awaiting carrier review. Contoh ini menggunakan referensi fiktif.

{
  "status": {
    "code": 200,
    "msg": "Address verification task created; awaiting carrier review."
  },
  "response": {
    "number": "+12125550123",
    "did_id": "11111111111111111111111111111111",
    "document_uuid": "0123456789abcdef0123456789abcdef",
    "identity_id": "22222222222222222222222222222222",
    "address_id": "33333333333333333333333333333333",
    "address_verification_id": "44444444444444444444444444444444",
    "verification_status": "pending",
    "verification_reference": null,
    "requirement_id": "55555555555555555555555555555555",
    "registration_details_id": "8516ac99dc60603295de7bdb6a153530"
  }
}

Pengenal terkait penyedia merupakan referensi tersamar, bukan ID profil lokal yang dapat saling menggantikan. document_uuid tetap merupakan referensi profil lokal yang Anda kirimkan. Dalam alur berbasis operator pada penangan ini, registration_details_id merupakan hasil hashing lanjutan atas referensi lokal tersebut; jangan gunakan nilai itu untuk menggantikan document_uuid dalam permintaan profil atau pengajuan berikutnya.

Beberapa nomor yang dialokasikan menggunakan pengaitan identitas lokal alih-alih membuat verifikasi operator. Hasil keberhasilannya adalah Identity associated. dengan larik response kosong. Hasil tersebut tidak membuat tugas peninjauan operator maupun menetapkan persetujuan. Portal memiliki alur pengaitan yang lebih baru dengan penanganan penyedia dan pemeriksaan pengajuan ulang yang berbeda dari titik akhir ini.

Tangani kesalahan tanpa membuat tugas duplikat

Kode API 400 mencakup nomor atau referensi profil yang tidak disertakan. Kode 404 mencakup profil atau nomor yang tidak tersedia bagi akun, atau nomor yang tidak ada dalam inventaris operator. Kode 422 dapat melaporkan referensi identitas/alamat yang tidak ada, persyaratan penjual, atau penolakan validasi operator. Konfigurasi panggilan balik yang tidak ada dapat menghasilkan 503, dan kegagalan transportasi saat pembuatan dapat menghasilkan 502. Baca pesan dan requirement_diagnostics jika ada, alih-alih memperlakukan semua kegagalan dengan cara yang sama.

Alur berbasis operator dapat memperbarui penanda registrasi tertunda lokal sebelum validasi persyaratan, pemeriksaan konfigurasi panggilan balik, atau pembuatan tugas selesai. Karena itu, kesalahan tidak berarti keadaan lokal tetap tidak berubah, dan penanda tertunda saja tidak membuktikan bahwa tugas telah ada. Jangan gunakan penanda tersebut sebagai konfirmasi persetujuan atau tersampaikannya permintaan.

Penyedia dapat menerima tugas meskipun operasi basis data lokal berikutnya gagal, dan fungsi bantu ini tidak memeriksa setiap hasil penulisan lokal sebelum melaporkan keberhasilan. Penangan ini tidak memiliki parameter idempotensi klien atau pengaman terhadap pengajuan duplikat. Setelah batas waktu terlampaui, terjadi kesalahan, atau hasilnya tidak pasti, periksa riwayat registrasi nomor di portal atau hubungi dukungan sebelum mengajukan kembali. Tidak adanya catatan lokal saja tidak membuktikan bahwa penyedia tidak menerima apa pun.

Batasan dokumen sekali pakai

Penangan menerima onetime_files dan meneruskan setiap string yang tidak kosong ke relasi berkas terenkripsi milik operator. Penangan tidak mencari baris data unggahan milik akun pemilik atau mengonversi ID unggahan eksternal tersamar menjadi ID berkas penyedia. Audit luring memverifikasi perilaku penerusan, bukan keberhasilan pelampiran pada operator.

Jangan menganggap ID berkas dari create_encrypt_files dapat disalin ke kolom ini untuk menyelesaikan alur perjanjian sekali pakai. Gunakan portal atau konfirmasikan alur penggunaan pengenal yang didukung kepada MultiTEL saat nomor memerlukan dokumen tersebut. Ini masih merupakan bagian yang belum terselesaikan dalam peninjauan API, bukan contoh yang telah diverifikasi dari awal hingga akhir.

Lindungi informasi registrasi

Hanya kirimkan informasi dan dokumen yang berwenang Anda gunakan untuk nomor tersebut. Pastikan referensi profil dan verifikasi tetap dikaitkan dengan akun yang benar, dan hindari mencatat seluruh muatan registrasi ke dalam log. Permintaan ini tidak menghapus atau mengganti semua bukti atau verifikasi sebelumnya. Peninjauan operator, aktivasi, dan retensi merupakan proses yang terpisah.