Unggah berkas bukti pendaftaran

Unggah sebelum melampirkan

Unggah berkas untuk satu kategori bukti atau dokumen pendukung, lalu lampirkan ID berkas yang dikembalikan menggunakan create_proof atau create_supporting_document. Mengunggah saja tidak membuat identitas, alamat, bukti, atau pendaftaran nomor yang sudah selesai. Mulailah dengan persyaratan terkini dan ID katalog.

Berikan tepat satu pemilih: proof_type_id untuk bukti identitas/alamat, atau supporting_template_id untuk dokumen pendukung. Jangan kirim keduanya. Gunakan ID yang dikembalikan oleh katalog MultiTEL yang sesuai; perlakukan ID tersebut sebagai pengenal yang struktur internalnya tidak boleh ditafsirkan.

Permintaan unggah

Gunakan akun API MultiTEL yang aktif beserta 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 dan nilai JSON status.code; kesalahan aplikasi dapat diterima dengan HTTP 200. Contoh di bawah ini bersifat fiktif.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --form-string "proof_type_id=$PROOF_TYPE_ID" \
  --form-string 'description=Identity proof' \
  --form 'files[0]=@./identity-proof.pdf' \
  https://api.multitel.net/v3/create_encrypt_files

Batas berkas

Penangan ini menerima maksimal lima berkas dengan ukuran total 20,000,000 bita. Batas ini menggunakan bita desimal, bukan 20 MiB. Infrastruktur atau validasi MIME dapat menerapkan batas tambahan.

Daftar ekstensi yang diizinkan adalah pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf dan csv. Ekstensi yang diizinkan tidak membuktikan bahwa berkas memenuhi persyaratan pendaftaran yang dipilih. Secara khusus, tif tidak termasuk dalam daftar yang diizinkan ini.

Periksa setiap berkas yang dikembalikan

{
  "status": {
    "code": 200,
    "msg": "Encrypt file has been created successfully"
  },
  "response": {
    "entity_type": "identities",
    "document_category": "proof",
    "proof_type": "11111111111111111111111111111111",
    "ids": [
      {
        "id": "22222222222222222222222222222222",
        "name": "identity-proof.pdf",
        "expired_at": "2026-10-23 16:20:00"
      }
    ]
  }
}

Simpan setiap response.ids[].id untuk permintaan pelampiran. name menunjukkan nama berkas sumber yang dikembalikan. Gunakan nama berkas yang berbeda dan bandingkan berkas yang dikembalikan dengan kumpulan yang diharapkan: kode 200 dapat menandakan bahwa sekumpulan unggahan hanya berhasil sebagian. Jangan lampirkan kumpulan yang tidak menyertakan semua berkas wajib.

entity_type bernilai identities atau addresses untuk bukti, dan supporting_documents untuk unggahan pendukung. document_category bernilai proof atau supporting. Kolom respons dengan nama umum proof_type juga memuat referensi templat untuk unggahan pendukung; simpan supporting_template_id asli Anda untuk pelampiran.

Segera lampirkan

Layanan menetapkan waktu kedaluwarsa sekitar 20 menit setelah unggahan disimpan secara lokal. Proses pelampiran memeriksa bahwa berkas dimiliki oleh akun yang sama, tidak ditandai kedaluwarsa, belum melewati waktu kedaluwarsanya, dan memiliki kategori entitas yang benar. expired_at tidak memiliki offset zona waktu dalam respons ini; jangan menganggapnya sebagai UTC. Segera lampirkan alih-alih menjadwalkan pekerjaan tepat di batas waktu.

Kedaluwarsanya referensi unggahan bukan jaminan bahwa semua salinan dokumen yang disimpan akan dihapus pada saat itu. Layanan mengenkripsi berkas untuk diunggah ke operator dan menyimpan bita sumber untuk alur kerja dokumen; jangan menganggapnya sebagai enkripsi yang hanya dilakukan di sisi klien atau layanan tanpa retensi data. Jangan masukkan ID, nama berkas, dan respons ke dalam log publik.

Kesalahan dan percobaan ulang

Penangan saat ini menggunakan kode API 404 jika tidak ada berkas dokumen yang diberikan, dan kode 500 untuk validasi deskripsi, pemilih yang tidak disertakan atau saling bertentangan, ID bukti/templat yang tidak valid, batas jumlah berkas atau ukuran total, masalah penyimpanan, atau unggahan yang gagal. Baca status.msg; masukan yang tidak valid tidak selalu ditunjukkan dengan kode 400.

Tidak ada kunci idempotensi klien yang disediakan di sini. Jika respons hilang, periksa alur kerja dokumen sebelum mengulangi unggahan; permintaan lain dapat membuat referensi berkas baru. Contoh ini belum dijalankan menggunakan dokumen identitas pelanggan.