Giden faks işlerini listeleme

Giden faks işlerini 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 giden faks kayıtlarını listeler. Listeleme işlemi faks iletmez veya yeniden göndermez.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

Bu istek işleyicisi date_from veya date_to filtrelerini desteklemez. Portalın giden kutusunda ek filtreler bulunur; bunlar bu API isteğine kopyalanmamalıdır. Sonuçlar oluşturulma zamanına göre en yeni kayıt ilk sırada olacak şekilde sıralanır; kimliğe göre ikincil sıralama veya anlık görüntü imleci kullanılmaz.

İş kayıtlarını okuma

Hem HTTP sonucunu hem de JSON yanıtındaki status.code değerini okuyun. Başarılı bir yanıt response.faxes ve response.pagination alanlarını içerir; örnekte kurgusal veriler kullanılmıştır. Boş bir posta kutusu için boş bir faxes dizisi döndürülür; total değeri 0 ve total_pages değeri 0 olur.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id sayısal kayıt kimliğidir. uuid görünür iş tanımlayıcısıdır; yeni gönderimlerde send_fax tarafından döndürülen iş kimliğini kullanın ve şu işlem için saklayın: durumu düzenli aralıklarla sorgulama. Liste eski kayıtlar da içerebilir; bu nedenle her satırın aynı gönderim uç noktası üzerinden oluşturulduğunu varsaymayın.

status ve result_text kaydedilmiş işleme durumunu ve mesajını içerir. Bu listeleme, bunları tüm teslimat durumlarını kapsayan bir numaralandırılmış değer kümesine dönüştürmez. Kuyrukta olması, teslim edildiği anlamına gelmez; yalnızca kuyruğa alındığını belirtir. Kritik belgelerde, faksı teslim edilmiş saymadan veya bir kopyasını daha göndermeden önce alıcıdan teslim aldığını doğrulamasını isteyin.

pages_requested ve pages_sent sayısal adetlerdir. cost saklanan değeri korur; bu değer bulunmadığında 0.00 dizesini kullanır. Gelen kutusundaki maliyetle aynı JSON türünde olduğunu varsaymayın. Kuyruktaki bir kayıt zaten tahmini bir tutar içerebilir. Ne bu değer ne de bir liste kaydı nihai faturalandırmayı belirler.

created_at, sent_at ve updated_at saat dilimi farkı içermeden, sunucunun biçiminde saklanan değerlerdir; sent_at değeri null olabilir. Liste, ayrı durum uç noktasının döndürdüğü webhook durumu alanını içermez.

Sonuç sayfalarındaki kayıtları güvenle eşleştirme

pagination.page, limit, total ve total_pages değerlerini takip edin. Son sayfadan sonraki sayfalar boş olabilir. Siz göz atarken yeni işler, kayıtların sayfalar arasında yer değiştirmesine yol açabilir. Sayfaları birleştirirken iş tanımlayıcılarını koruyun; bu uç nokta değişmeyen bir anlık görüntü garantisi vermez.

Gizlilik ve yeniden denemeler

Giden kutusu kayıtları özel telefon üst verileri içerir. Bu kayıtları okuyabilecek kişileri sınırlandırın ve yanıtların tamamını günlüklere kaydetmekten kaçının. Listede bir kaydın bulunmaması, gönderim isteğinin başarısız olduğunu kanıtlamaz: yeniden göndermeden önce sakladığınız iş kimliğini ve portalın giden kutusunu kontrol edin. Yeni bir gönderim, ücretlendirilebilecek başka bir faks oluşturabilir. Arka plan işleyicisi, faturalandırma, geri çağrı ve veri saklamaya ilişkin nihai garantiler hâlâ incelenmektedir.