อ่านบันทึกการโทรของบัญชี

ดึงบันทึกการโทรของบัญชี

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

ปัจจุบันปลายทางรุ่นเก่านี้ใช้ช่วงวันที่เริ่มต้นแบบตายตัวและไม่มีการแบ่งหน้า หากต้องการช่วงรายงานอื่นหรือส่งออกข้อมูลย้อนหลังจำนวนมาก ให้ใช้ขั้นตอนดูประวัติการโทร/ส่งออกข้อมูลในพอร์ทัล เนื่องจากพารามิเตอร์วันที่ที่กำหนดเองของปลายทางนี้ทำงานได้ไม่แน่นอน

คำขอ

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cdrs

ใช้ค่าทิศทาง inbound หรือ outbound ให้ตรงตามที่แสดงด้านบน ส่วนประมวลผลการโทรออกไม่ได้รองรับตัวกรองแยกตามหมายเลข การเพิ่มหมายเลขลงในเส้นทางนั้นจะไม่จำกัดผลลัพธ์การโทรออกให้แคบลง

ช่วงเวลารายงานเริ่มต้น

การค้นหาเริ่มตั้งแต่เที่ยงคืนของวันที่ย้อนหลังไป 30 วันก่อนวันนี้ตามปฏิทินของเซิร์ฟเวอร์ และสิ้นสุดที่เที่ยงคืนเมื่อเริ่มต้นวันนี้ จึงไม่รวมเวลาที่เหลือของวันปัจจุบัน ช่วงนี้ไม่ใช่ช่วงเวลาเลื่อนย้อนหลัง 720 ชั่วโมงที่สิ้นสุด ณ เวลาปัจจุบัน

การทำงานในปัจจุบันรองรับฟิลด์แบบฟอร์ม date_from/date_to ได้ไม่แน่นอน: เมื่อระบุวันที่ที่กำหนดเอง ตัวแปรปีของพาร์ทิชันจะไม่ได้รับการกำหนดค่า อย่าใช้ฟิลด์เหล่านี้จัดทำรายงานในระบบใช้งานจริง และยังไม่มีการรองรับวันที่ในสตริงคำค้นหรือพารามิเตอร์แบ่งหน้าเป็นทางเลือกทดแทน

การตอบกลับ

แสดงเฉพาะฟิลด์การโทรเข้าบางส่วนเพื่อเป็นตัวอย่างเท่านั้น ข้อมูลนี้เป็นข้อมูลสมมติและไม่ใช่บันทึกฉบับเต็มที่ส่งกลับ

{
  "status": {
    "code": "200",
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "callerid": "12025550124",
      "disposition": "ANSWERED",
      "billseconds": "60",
      "billcost": "0.0100",
      "callsid": "11111111111111111111111111111111",
      "date_created": "2026-10-01 12:00:00 UTC"
    }
  ]
}

response เป็นรายการ โครงสร้างห่อหุ้มการตอบกลับที่ใช้ร่วมกันอาจมี status.results เพื่อระบุจำนวนแถว รหัสผลลัพธ์อาจเป็นสตริง เมื่อไม่พบบันทึก ผลลัพธ์จะใช้รหัส API 404 พร้อมข้อความ No entries found แทนการส่งรายการว่างกลับด้วยสถานะสำเร็จ

ฟิลด์ของบันทึก

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

ข้อผิดพลาดและข้อจำกัดในการจัดทำรายงาน

อ่านทั้งสถานะ HTTP และ status.code/status.msg ใน JSON หากไม่มีรายการในบัญชี/ช่วงเวลาที่เลือก จะส่งรหัส API 404 กลับมา โดยยังมีข้อกำหนดการยืนยันตัวตนและข้อจำกัด IP ต้นทางด้วย รายงานขนาดใหญ่ที่ไม่มีการแบ่งหน้าหรือคำขอวันที่ที่กำหนดเองซึ่งทำงานได้ไม่แน่นอนอาจล้มเหลว การดึงข้อมูลทั้งตารางซ้ำ ๆ ไม่ใช่วิธีส่งออกเฉพาะข้อมูลที่เพิ่มขึ้น

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