Faks işinin durumunu kontrol edin

Faks işinizi sorgulayın

Etkin bir MultiTEL API hesabı kullanın. Parolalı hesap için HTTP Basic kimlik bilgilerini veya belirteçli hesap için Bearer belirtecini gönderin. Hesap izinleri ve IP kısıtlamaları geçerliliğini korur. Dahili işleyici kimlik bilgilerini kullanmayın.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_status

job_id zorunludur ve send_fax tarafından döndürülen 32 karakterli onaltılık tanımlayıcı olmalıdır. Aynen kopyalayın. İstekler, kimliği doğrulanan sahibin işleriyle sınırlıdır.

Sonucu okuyun

Hem HTTP sonucunu hem de JSON içindeki status.code değerini okuyun. JSON hataları HTTP 200 ile gelebilir. Başarılı bir JSON yanıtında status ve response bulunur; örneklerde kurgusal veriler kullanılır.

{
  "status": {
    "code": 200,
    "msg": "Fax status"
  },
  "response": {
    "job_id": "0123456789abcdef0123456789abcdef",
    "from_number": "+12125550123",
    "to_number": "+12125550124",
    "status": "queued",
    "result": "",
    "pages_requested": 3,
    "pages_sent": 0,
    "cost": "0.07500",
    "webhook_status": "",
    "created_at": "2026-10-23 10:00:00",
    "updated_at": "2026-10-23 10:00:00"
  }
}

Örnek, kuyruğa alınmış bir iştir; teslim edilmiş bir faks veya fiyat teklifi değildir. pages_requested algılanan kaynak sayfa sayısıdır; pages_sent işleme sırasında kaydedilen ilerlemeyi bildirir. cost ondalık sayı içeren bir dizgedir ve iş kuyruktayken bile bir tahmin içerebilir. result işleme ayrıntılarını içerir; webhook_status kaydedilen geri çağrı durumunu içerir. Zaman damgaları, saat dilimi farkı içermeyen, sunucu tarafından biçimlendirilmiş dizgelerdir.

Sıkı bir döngü yerine giderek uzayan aralıklarla sorgulayın. İşleme, gönderildi veya tamamlandı durumu bildirebilir; ancak mevcut denetim alıcıya teslim garantisi ortaya koymamıştır. Önemli bir belgeyi teslim edilmiş saymadan veya yeniden göndermeden önce alıcıdan teslim alındığını doğrulayın. Etkin işleyici yaşam döngüsü, nihai faturalandırma kuralları ve geri çağrı sözleşmesi hâlâ doğrulanmaktadır. Kuyruğa kabulün veya boş olmayan bir iş kimliğinin teslim anlamına geldiğini varsaymayın.

Hatalar

API kodu 400, job_id değerinin eksik veya hatalı olduğunu; 401, kimlik doğrulamasının eksik olduğunu; 404 ise işin bu hesap için bulunamadığını belirtir. Yalnızca tanımlayıcıya bakarak sahiplik sonucu çıkarmayın.