Minta dokumen
Gunakan akun API MultiTEL yang telah diaktifkan. Kirim kredensial HTTP Basic untuk akun berbasis kata sandi, atau token Bearer untuk akun berbasis token. Izin akun dan pembatasan alamat IP tetap berlaku. Jangan gunakan kredensial proses pekerja internal.
curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
--data-urlencode job_id=0123456789abcdef0123456789abcdef \
--dump-header fax-response.headers --output fax-response.bin \
https://api.multitel.net/v3/fax_downloadGunakan job_id heksadesimal sepanjang 32 karakter yang wajib diisi, sama seperti pada fax_status. Permintaan pelanggan hanya dapat dilakukan oleh pemilik yang telah diautentikasi. Contoh ini menyimpan header dan bita respons secara terpisah agar kesalahan API tidak disalahartikan sebagai PDF.
Tangani berkas atau kesalahan JSON
Jika berhasil, respons mengembalikan bita mentah dokumen beserta header lampiran Content-Type dan Content-Disposition, bukan pembungkus JSON. Periksa header tersebut sebelum memberi nama, membuka, atau memproses berkas yang disimpan. Respons dapat berupa PDF, TIFF, atau format asli berkas yang diunggah, tergantung pada dokumen yang tersedia. Pekerjaan dalam antrean dapat mengembalikan berkas sumber aslinya sebelum konversi.
Jika gagal, respons mengembalikan pembungkus JSON status/response yang biasa digunakan. Kode API 400 berarti job_id tidak disertakan atau formatnya salah; 401 berarti autentikasi tidak disertakan; 404 berarti pekerjaan atau berkasnya tidak tersedia untuk akun ini. Periksa Content-Type dan status.code meskipun status HTTP adalah 200.
Ketersediaan dan privasi
Adanya catatan pekerjaan tidak menjamin bahwa berkasnya dapat diunduh selamanya; jangka waktu penyimpanan belum diverifikasi. Bila diperlukan, simpan dokumen yang boleh Anda akses ke penyimpanan yang Anda kendalikan sendiri. Berkas yang dikembalikan dapat memuat informasi pribadi penerima. Mengunduh tidak mengirimkan faks baru.