Belgeyi isteyin
Etkin bir MultiTEL API hesabı kullanın. Parolalı bir hesap için HTTP Basic kimlik bilgilerini, belirteçli bir hesap için ise Bearer belirtecini gönderin. Hesap izinleri ve IP kısıtlamaları geçerli olmaya devam eder. Dahili arka plan işleyicisinin kimlik bilgilerini kullanmayın.
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_downloadfax_status için kullanılan zorunlu 32 karakterlik onaltılık job_id değerinin aynısını kullanın. Müşteri isteğini yalnızca kimliği doğrulanmış iş sahibi yapabilir. Bu örnek, bir API hatasının PDF belgesi sanılmasını önlemek için yanıt başlıklarını ve baytlarını ayrı ayrı kaydeder.
Dosyayı veya JSON hatasını işleyin
Başarılı olduğunda, JSON yanıt zarfı yerine Content-Type ve dosyanın ek olduğunu belirten Content-Disposition başlıklarıyla birlikte belgenin ham baytları döndürülür. Kaydedilen dosyayı adlandırmadan, açmadan veya işlemeden önce bu başlıkları kontrol edin. Hangi belgenin mevcut olduğuna bağlı olarak yanıt PDF, TIFF veya yüklenen dosyanın özgün biçiminde olabilir. Kuyruktaki bir iş için dönüştürme öncesinde özgün kaynak dosyası döndürülebilir.
Başarısız olduğunda standart JSON status/response yanıt zarfı döndürülür. API kodu 400, job_id değerinin eksik veya hatalı biçimlendirilmiş olduğunu; 401, kimlik doğrulamanın eksik olduğunu; 404 ise işin veya dosyasının bu hesap için erişilebilir olmadığını belirtir. HTTP durum kodu 200 olsa bile Content-Type başlığını ve status.code değerini kontrol edin.
Erişilebilirlik ve gizlilik
Bir iş kaydının bulunması, dosyanın süresiz olarak indirilebileceğini garanti etmez; saklama süresi doğrulanmamıştır. Gerektiğinde, erişim yetkiniz olan belgeleri kendi denetiminizdeki bir depolama alanına kaydedin. Döndürülen dosya, alıcıya ait özel bilgiler içerebilir. İndirme işlemleri yeni bir faks göndermez.