ตรวจสอบสถานะงานแฟกซ์

ค้นหางานของคุณ

ใช้บัญชี MultiTEL API ที่เปิดใช้งานแล้ว สำหรับบัญชีรหัสผ่าน ให้ส่งข้อมูลรับรอง HTTP Basic หรือส่งโทเค็น Bearer สำหรับบัญชีโทเค็น สิทธิ์ของบัญชีและข้อจำกัด IP ยังคงมีผล อย่าใช้ข้อมูลรับรองภายในของเวิร์กเกอร์

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

job_id เป็นข้อมูลที่ต้องระบุ และต้องเป็นตัวระบุเลขฐานสิบหก 32 อักขระที่ send_fax ส่งกลับ คัดลอกให้ตรงทุกตัว คำขอจำกัดอยู่ภายใต้เจ้าของที่ยืนยันตัวตนแล้ว

อ่านผลลัพธ์

อ่านทั้งผลลัพธ์ HTTP และฟิลด์ status.code ใน JSON ความล้มเหลวของ JSON อาจส่งกลับพร้อม HTTP 200 การตอบกลับ JSON ที่สำเร็จมี status และ response โดยตัวอย่างใช้ข้อมูลสมมติ

{
  "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"
  }
}

ตัวอย่างเป็นงานที่อยู่ในคิว ไม่ใช่แฟกซ์ที่ส่งถึงผู้รับแล้วหรือใบเสนอราคา pages_requested คือจำนวนหน้าต้นฉบับที่ตรวจพบ ส่วน pages_sent รายงานความคืบหน้าที่บันทึกระหว่างการประมวลผล cost เป็นสตริงเลขทศนิยม และอาจมีค่าประมาณอยู่แล้วขณะรอในคิว result มีรายละเอียดการประมวลผล ส่วน webhook_status มีสถานะคอลแบ็กที่บันทึกไว้ เวลาประทับเป็นสตริงตามรูปแบบเซิร์ฟเวอร์โดยไม่มีค่าออฟเซ็ตเขตเวลา

ตรวจสอบซ้ำโดยเพิ่มช่วงเวลาระหว่างคำขอ แทนการวนลูปถี่ ๆ การประมวลผลอาจรายงานสถานะว่าส่งแล้วหรือเสร็จแล้ว แต่การตรวจสอบปัจจุบันยังไม่ได้ยืนยันการรับประกันว่าจะส่งถึงผู้รับ สำหรับเอกสารสำคัญ ให้ยืนยันการได้รับเอกสารกับผู้รับก่อนถือว่าส่งถึงแล้วหรือส่งซ้ำ วงจรการทำงานของเวิร์กเกอร์ที่ใช้งานอยู่ กฎการเรียกเก็บเงินขั้นสุดท้าย และข้อกำหนดคอลแบ็กยังอยู่ระหว่างการตรวจสอบ อย่าสันนิษฐานว่าการรับเข้าคิวหรือ ID งานที่ไม่ว่างหมายถึงส่งถึงผู้รับแล้ว

ข้อผิดพลาด

รหัส API 400 หมายถึงไม่มี job_id หรือมีรูปแบบไม่ถูกต้อง; 401 หมายถึงไม่มีการยืนยันตัวตน; 404 หมายถึงไม่พบงานสำหรับบัญชีนี้ อย่าอนุมานความเป็นเจ้าของจากตัวระบุเพียงอย่างเดียว