Alınan faksları listeleme

Alınan faksları listeleme

Etkinleştirilmiş bir MultiTEL API hesabını, yapılandırılmış kimlik bilgileri ve IP kısıtlamalarıyla HTTPS üzerinden kullanın. Bu uç nokta, kimliği doğrulanmış hesaba ait alınan faksları listeler. Faks göndermez veya faksın belgesini indirmez.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode date_from=2026-10-01 \
  --data-urlencode date_to=2026-10-02 \
  https://api.multitel.net/v3/fax_inbox

Tarih sınırları dahildir ve istenen kullanıcı saat dilimi yerine API sunucusunun tarih yorumlaması kullanılır. Geçersiz tarih dizeleri reddedilmek yerine yok sayılabilir; göndermeden önce bunların geçerliliğini denetleyin. Tarih filtresi yoksa istek işleyicisi varsayılan bir tarih aralığı uygulamaz. Sonuçlar alınma zamanına göre, en yeniler önce gelecek şekilde sıralanır. Uç nokta, sayfalar arasında sabit bir anlık görüntü sağlamaz: yeni gelen fakslar kayıtların sayfalar arasında yer değiştirmesine neden olabilir.

Posta kutusu sayfasını sorgulama

HTTP sonucunu ve JSON yanıtındaki status.code alanını kontrol edin. API içindeki diğer bölümlerde oluşan hatalar, HTTP durumu 200 olduğunda bile JSON biçiminde bir hata zarfıyla döndürülebilir. Başarılı bir yanıt, response.faxes ve response.pagination alanlarını içerir. Bu örnekte kurgusal değerler kullanılmıştır.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 12,
      "hash": "c20ad4d76fe97759aa27a0c99bff6710",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "remote_station_id": "Example sender",
      "pages": 2,
      "cost": 0.05,
      "received_at": "2026-10-01 12:00:00",
      "received_timestamp": 1790856000,
      "status": "success",
      "status_text": "OK",
      "emailed": "yes",
      "viewed": false
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id gelen kutusu kaydının sayısal kimliğidir. hash eski gelen belge iş akışı için bu kimliğin MD5 gösterimidir; bir send_fax iş kimliği veya yetkilendirme kimlik bilgisi değildir. Bunu giden fakslara yönelik fax_status uç noktasıyla kullanmayın.

received_timestamp saklanan Unix zaman damgasıdır. received_at saat dilimi farkı içermeyen, sunucu tarafından biçimlendirilmiş bir zaman damgasıdır; alınma zamanı kaydedilmemişse null değerindedir. Zamanları kendi saat diliminizde gösterirken Unix değerini kullanın. cost bir JSON sayısıdır; fiyat teklifi veya ayrı bir ücret tahsilatının tamamlandığına dair kanıt değildir.

status yalnızca saklanan durum kodu sıfır olduğunda success değerini alır; diğer değerler failed olur. status_text saklanan işleme mesajını içerir; bu mesaj yoksa OK veya Failed kullanılır. emailed mantıksal bir değer yerine saklanan değeri korur. viewed mantıksal bir değerdir. Yalnızca faks durumuna bakarak e-postanın başarıyla teslim edildiği sonucuna varmayın.

Boş ve değişen listeleri işleme

Boş bir posta kutusu için boş bir faxes dizisi, total alanında 0 ve total_pages alanında 0 döndürülür. Son sayfanın ötesindeki bir sayfa da boş bir dizi döndürebilir. En az bir sayfa olduğunu varsaymak yerine sayfalama alanlarına göre durun. İmleç veya kayıt kimliğine göre ikincil sıralama sunulmaz. Örtüşen sayfalardaki kayıtları uzlaştırırken kayıt kimliklerini saklayın.

Belge erişimi ve gizlilik

Posta kutusu kayıtları gizli telefon ve belge üst verileri içerir. Uygulamanızda erişimi kısıtlayın ve yanıtların tamamını günlüklere kaydetmekten kaçının. Listeleme, belgeyi görüntülenmiş olarak işaretlemez. Geriye dönük uyumluluk kapsamındaki gelen belge indirme işlemi için fax_file uç noktasını kullanın; dosyası mevcut olmasa bile var olan bir gelen kaydını görüntülenmiş olarak işaretlediğini unutmayın. Belgelere portalın gelen kutusundan da erişilebilir. Dosyaların saklanmasına ilişkin bir garanti belirlenmemiştir.