Lampirkan dokumen pendukung

Lampirkan dokumen pendukung berbasis templat

Gunakan templat dari get_supporting_document_templates dan identitas yang sudah dimiliki akun Anda. Unggah berkas dokumen tersebut melalui create_encrypt_files menggunakan supporting_template_id. Unggahan bukti identitas atau alamat biasa termasuk dalam kategori yang berbeda dan tidak dapat digunakan sebagai penggantinya.

Buat dokumen pendukung

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

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

{
  "identity_id": "33333333333333333333333333333333",
  "template_id": "55555555555555555555555555555555",
  "encrypted_file_ids": [
    "66666666666666666666666666666666"
  ]
}

Kolom permintaan
Kolom	Arti
`identity_id`	ID identitas yang terkait dengan akun Anda wajib diisi. Permintaan ini melampirkan dokumen ke sebuah identitas, bukan langsung ke alamat atau nomor telepon.
`template_id`	ID templat dokumen pendukung wajib diisi; gunakan templat terpilih yang sama dengan yang digunakan untuk unggahan pendukung. Kolom untuk melampirkan adalah template_id, sedangkan kolom untuk mengunggah adalah supporting_template_id.
`encrypted_file_ids`	Larik JSON yang tidak kosong berisi ID unggahan yang dikembalikan wajib diisi. Setiap unggahan harus dimiliki akun saat ini, belum kedaluwarsa, dan termasuk dalam kategori supporting_documents.

Data formulir dengan kolom encrypted_file_ids[] yang berulang juga diterima. Jangan kirim bita berkas ke titik akhir pelampiran ini.

Dokumen pendukung yang dibuat

{
  "status": {
    "code": 200,
    "msg": "Supporting document created successfully."
  },
  "response": {
    "id": "77777777777777777777777777777777",
    "template_id": "55555555555555555555555555555555",
    "identity_id": "33333333333333333333333333333333",
    "template_name": "Example supporting template"
  }
}

Ini mengonfirmasi pembuatan dokumen pendukung, bukan persetujuan regulator atau aktivasi nomor. Istilah permanen dalam sumber daya hulu bukan jaminan kepada pelanggan mengenai durasi penyimpanan atau kebijakan penghapusan.

Kesalahan dan percobaan ulang

Kode API 500 menunjukkan masukan yang tidak diberikan, kesalahan operator telekomunikasi, atau respons operator yang tidak valid. Kode 404 menunjukkan identitas yang tidak terkait dengan akun, templat yang tidak valid, unggahan yang tidak ditemukan, sudah kedaluwarsa, atau salah kategori, atau kumpulan berkas yang dapat digunakan yang kosong. Periksa status.msg; HTTP 200 saja tidak cukup.

Unggah dan lampirkan selama masa berlaku referensi berkas yang dikembalikan. Jika respons yang diterima tidak memberikan kepastian, periksa dokumen pendukung identitas tersebut di portal sebelum mencoba lagi. Penangan ini tidak menyediakan kunci idempotensi.