Lampirkan bukti identitas atau alamat

Gunakan langkah ini setelah identitas atau alamat tersedia dan setelah berkas yang diperlukan diunggah melalui create_encrypt_files dengan jenis bukti yang dipilih. Gunakan ID yang masih berlaku dari get_proof_types, yang sesuai dengan persyaratan dan kategori entitas.

Simpan identity_id dan address_id dari create_document; UUID profil berbeda. Kompatibilitas pelampiran bukti alamat di kemudian hari untuk profil yang baru dibuat masih ditinjau. Jika alamat ditolak, periksa portal atau hubungi dukungan sebelum mencoba lagi.

Buat bukti

Gunakan akun API MultiTEL yang aktif beserta alamat IP yang diizinkan untuk akun tersebut. Contoh menggunakan kredensial HTTP Basic dari variabel lingkungan; ikuti aturan autentikasi untuk jenis akun Anda. Kirim permintaan melalui HTTPS. Periksa respons HTTP serta nilai berikut dalam JSON: status.code; kesalahan aplikasi dapat diterima bersama respons HTTP 200. Contoh di bawah ini bersifat fiktif.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

Kolom permintaan
Kolom	Arti
`entity_type`	Gunakan identities atau addresses. Pilih kategori yang sesuai dengan target Anda sekaligus berkas yang diunggah.
`entity_id`	ID identitas atau alamat milik akun Anda. Gunakan pengenal yang dikembalikan oleh alur pengelolaan dokumen Anda; jangan menggantinya dengan nomor telepon atau ID dokumen yang tidak terkait.
`proof_type_id`	ID jenis bukti yang dipilih. Pastikan ID ini sesuai dengan unggahan dan persyaratan.
`encrypted_file_ids`	Larik JSON yang tidak kosong berisi ID berkas yang dikembalikan oleh create_encrypt_files. Berkas harus dimiliki oleh akun yang sama, belum kedaluwarsa, dan sesuai dengan kategori entitas. Ini bukan daftar jalur berkas lokal.

Data formulir juga diterima dengan pengulangan kolom encrypted_file_ids[]. Utamakan larik JSON yang sebenarnya atau larik formulir; jangan mengirim larik yang dikodekan sebagai JSON sebagai nilai skalar formulir biasa.

Simpan ID bukti

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

Respons yang berhasil mengonfirmasi bahwa bukti telah dihubungkan dengan identitas atau alamat. Respons tersebut tidak mengonfirmasi persetujuan identitas/alamat, validasi seluruh persyaratan negara, atau aktivasi nomor telepon.

Kesalahan dan unggahan kedaluwarsa

Kode API 500 digunakan ketika masukan wajib tidak tersedia, terjadi kegagalan pada operator telekomunikasi, atau respons operator tidak valid. Kode 404 digunakan ketika target tidak terkait dengan akun saat ini, jenis bukti tidak valid, berkas yang diunggah tidak dapat ditemukan untuk akun/kategori ini atau telah kedaluwarsa, atau tidak ada lagi ID berkas yang dapat digunakan. Baca status.msg bersama kodenya.

Unggah ulang berkas wajib yang telah kedaluwarsa menggunakan kategori bukti yang benar sebelum melampirkannya. Jika ada berkas yang diberikan tidak valid, penangan ini berhenti sebelum mengirim permintaan pembuatan bukti. Tidak ada kunci idempotensi yang disediakan: setelah batas waktu terlampaui, periksa dokumen yang sudah ada di portal sebelum mengulangi pelampiran.