แสดงรายการงานแฟกซ์ขาออก

แสดงรายการงานแฟกซ์ขาออก

ใช้บัญชี API ของ MultiTEL ที่เปิดใช้งานแล้วผ่าน HTTPS โดยใช้ข้อมูลรับรองและข้อจำกัดด้านที่อยู่ IP ที่กำหนดไว้สำหรับบัญชีนั้น จุดเชื่อมต่อนี้แสดงรายการระเบียนแฟกซ์ขาออกที่เป็นของบัญชีที่ยืนยันตัวตนแล้ว การแสดงรายการไม่ได้ส่งหรือส่งแฟกซ์ซ้ำ

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

ตัวจัดการนี้ไม่รองรับตัวกรอง date_from หรือ date_to กล่องแฟกซ์ขาออกในพอร์ทัลมีตัวกรองเพิ่มเติมซึ่งไม่ควรคัดลอกมาใช้ในคำขอ API นี้ ผลลัพธ์เรียงตามเวลาที่สร้าง โดยรายการใหม่ที่สุดอยู่ก่อน ไม่มีการเรียงลำดับรองตามรหัสระบุหรือเคอร์เซอร์สำหรับภาพข้อมูล ณ จุดเวลาใดเวลาหนึ่ง

อ่านระเบียนงาน

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

{
  "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 คือรหัสระบุระเบียนที่เป็นตัวเลข uuid คือรหัสระบุงานที่แสดงให้เห็น สำหรับการส่งใหม่ให้ใช้รหัสงานที่ส่งกลับจาก send_fax และเก็บรหัสนั้นไว้เพื่อใช้ในการ สอบถามสถานะเป็นระยะ รายการอาจมีระเบียนเก่ารวมอยู่ด้วย จึงไม่ควรสันนิษฐานว่าทุกแถวถูกสร้างผ่านจุดเชื่อมต่อสำหรับส่งเดียวกัน

status และ result_text มีสถานะการประมวลผลและข้อความที่บันทึกไว้ การแสดงรายการนี้ไม่ได้ปรับค่าเหล่านี้ให้อยู่ในชุดค่ามาตรฐานที่ครอบคลุมสถานะการส่งถึงทั้งหมด สถานะเข้าคิวหมายถึงกำลังรอในคิว ไม่ได้หมายความว่าส่งถึงแล้ว สำหรับเอกสารสำคัญ ให้ยืนยันกับผู้รับว่าได้รับเอกสารแล้วก่อนถือว่าส่งแฟกซ์ถึงแล้วหรือส่งเอกสารซ้ำ

pages_requested และ pages_sent เป็นค่าจำนวนที่เป็นตัวเลข cost คงค่าที่จัดเก็บไว้ โดยใช้สตริง 0.00 เป็นค่าสำรอง อย่าสันนิษฐานว่าค่านี้มีชนิดข้อมูล JSON เดียวกับค่าบริการในกล่องแฟกซ์ขาเข้า ระเบียนที่อยู่ในคิวอาจมีค่าประมาณอยู่แล้ว ทั้งค่านั้นและรายการในผลลัพธ์ต่างก็ไม่ได้ยืนยันค่าบริการสุดท้าย

created_at, sent_at และ updated_at เป็นค่าที่จัดเก็บในรูปแบบของเซิร์ฟเวอร์โดยไม่มีค่าออฟเซ็ตเขตเวลา sent_at อาจเป็น null รายการนี้ไม่รวมฟิลด์สถานะเว็บฮุกที่ส่งกลับโดยจุดเชื่อมต่อสถานะซึ่งแยกต่างหาก

ตรวจสอบข้อมูลระหว่างหน้าผลลัพธ์อย่างปลอดภัย

ติดตามค่า pagination.page, limit, total และ total_pages หน้าที่เกินหน้าสุดท้ายอาจว่าง งานใหม่อาจทำให้รายการย้ายไปมาระหว่างหน้าในขณะที่คุณเรียกดู เก็บรหัสระบุงานไว้เมื่อรวมข้อมูลจากหลายหน้า จุดเชื่อมต่อนี้ไม่รับประกันว่าข้อมูลจะเป็นภาพ ณ จุดเวลาเดียวกันที่คงที่

ความเป็นส่วนตัวและการลองใหม่

ระเบียนในกล่องแฟกซ์ขาออกมีเมทาดาทาทางโทรศัพท์ที่เป็นข้อมูลส่วนตัว จำกัดผู้ที่มีสิทธิ์อ่านและหลีกเลี่ยงการบันทึกการตอบกลับทั้งหมดลงในบันทึกระบบ การไม่พบรายการไม่ได้พิสูจน์ว่าคำขอส่งล้มเหลว ให้ตรวจสอบรหัสงานที่เก็บไว้และกล่องแฟกซ์ขาออกในพอร์ทัลก่อนส่งคำขออีกครั้ง การส่งใหม่อาจสร้างแฟกซ์อีกฉบับที่อาจมีค่าบริการ ข้อรับประกันขั้นสุดท้ายเกี่ยวกับตัวประมวลผลเบื้องหลัง การคิดค่าบริการ การเรียกกลับ และการเก็บรักษาข้อมูลยังอยู่ระหว่างการทบทวน