Ganti detail profil yang dapat diedit
Perbarui profil pendaftaran yang sudah ada dan dimiliki akun menggunakan UUID lokalnya dari create_document atau documents. Operasi ini mengubah data akun dan data pada operator hulu. Operasi ini tidak mengubah jenis identitas Personal/Business yang tersimpan dan bukan PATCH untuk sebagian kolom.
Permintaan pembaruan
Lakukan autentikasi dengan akun API MultiTEL Anda yang aktif dari alamat IP yang diizinkan. Contoh menggunakan kredensial dalam variabel lingkungan dan data fiktif. Baca status.code dan status.msg dalam JSON serta respons HTTP.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--header 'Content-Type: application/json' \
--data @registration-profile-update.json \
"https://api.multitel.net/v3/update_document/$DOCUMENT_UUID"{
"first_name": "Example",
"last_name": "Person",
"phone_number": "12025550123",
"email": "end-user@example.com",
"city": "Example City",
"postal_code": "00000",
"address": "1 Example Street",
"country": "US",
"nationality": "US",
"signature": "BASE64_PNG_OF_THE_AUTHORIZED_END_USER_SIGNATURE",
"id_number": "",
"personal_tax_id": "",
"birth_date": "",
"description": "Example profile",
"company_name": "",
"company_reg_number": "",
"incorporation_country": "",
"vat_id": "",
"address_description": ""
}Contoh ini menampilkan profil Personal; ganti isinya dengan seluruh detail yang diinginkan dan tanda tangan yang diotorisasi milik pengguna akhir. Jangan mengirim tanda tangan pengganti atau nilai kosong sebagai cara untuk mempertahankan data. Masukan JSON dan masukan dengan pengodean formulir didukung.
| Kolom | Perilaku |
|---|---|
| first_name, last_name, city, postal_code, address | Wajib; masing-masing maksimal 64 karakter. |
| phone_number | Wajib berupa nilai numerik dengan panjang minimal delapan karakter; gunakan digit internasional termasuk kode negara. |
| signature | Wajib. Portal menyediakan byte PNG dalam Base64 tanpa prefiks URL data. |
| country | Berikan kode ISO negara alamat dari katalog pendaftaran. Handler menentukan negara yang sesuai dengan kode tersebut, meskipun proses pembaruan alamat yang ditinjau tidak mengubah relasi negara. |
| nationality | Kode ISO negara wajib diberikan untuk profil Personal yang sudah ada. |
| company_name, incorporation_country | Wajib untuk profil Business yang sudah ada; nama perusahaan maksimal 64 karakter dan negara pendirian perusahaan harus berupa kode ISO. |
| Alamat email valid bersifat opsional, maksimal 254 karakter. Jangan sertakan kolom ini untuk mempertahankan email kontak yang tersimpan; kirim nilai kosong untuk menghapusnya secara lokal. | |
| id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id | Kirim nilai terkini yang diinginkan. Nilai yang tidak disertakan secara default menjadi kosong dan dapat menimpa nilai yang sudah tersimpan. |
Aturan pendaftaran khusus negara mungkin mewajibkan informasi atau format tambahan. Jangan menyusun ulang pembaruan lengkap hanya berdasarkan get_document: responsnya yang terbatas tidak menyertakan pemilih negara, email, dan ID entitas. Simpan data sumber yang diotorisasi untuk Anda atau gunakan editor dokumen pada portal.
Lanjutan: tambahkan bukti yang telah diunggah
Larik opsional identity_encryptfiles dan address_encryptfiles menerima referensi aktif yang dimiliki akun dari create_encrypt_files. Cocokkan kategori entitas unggahan dan kirim sebelum referensi kedaluwarsa. Setiap berkas dilampirkan dalam permintaan bukti tersendiri, meskipun beberapa berkas memiliki jenis bukti yang sama. Untuk bukti identitas dengan beberapa berkas, gunakan alur kerja lanjutan untuk pelampiran bukti dengan satu larik.
Jika bukti alamat yang dikirim kemudian ditolak untuk alamat yang baru dibuat, jangan menggunakan UUID profil sebagai pengganti atau membuat ulang identitas berulang kali. Berhenti dan periksa profil di portal atau bersama dukungan. Jalur pembacaan ulang/pencarian bukti alamat masih menjadi keterbatasan peninjauan.
Respons keberhasilan dan kegagalan lama
{
"status": {
"code": "success",
"msg": "Successfully Saved."
},
"response": ""
}Kode keberhasilan normal endpoint ini adalah string success, bukan angka 200. Kegagalan normal pada sistem hulu atau lokal dapat menggunakan string error. Kode numerik 400 mencakup kolom tidak valid atau kegagalan bukti, 404 menunjukkan profil tidak ditemukan atau referensi berkas unggahan tidak valid, dan 500 menunjukkan isi permintaan kosong atau negara tidak dapat ditentukan. Baca pesan dan setiap entri validasi; jangan menganggap HTTP 200 saja sebagai keberhasilan.
Batasan pembaruan saat ini dan pemulihan
Laporan keberhasilan tidak menjamin bahwa setiap kolom pada sistem hulu telah berubah. Kode yang ditinjau dapat menyimpan profil lokal setelah pembaruan alamat pada sistem hulu gagal. Pembaruan identitas pada sistem hulu tidak menyertakan email. Belum dipastikan bahwa perubahan negara alamat dan sinkronisasi deskripsi alamat dilakukan melalui proses ini. Jika Anda memerlukan perubahan tersebut, tinjau hasilnya di portal dan hubungi dukungan alih-alih menganggap pendaftaran pada sistem hulu telah diperbarui.
Pembaruan ini bukan satu transaksi atomik: perubahan identitas dan pelampiran bukti dapat terjadi sebelum kegagalan pada tahap berikutnya. Kunci idempotensi tidak disediakan. Setelah menerima respons yang tidak pasti, periksa profil dan lampiran sebelum mencoba lagi; pengiriman bukti berulang dapat membuat duplikat. Memperbarui profil tidak memastikan persetujuan bukti atau mengaktifkan nomor.