อ่านเหตุการณ์ของโครงการย้ายค่ายเบอร์เดิม

การเข้าถึงบัญชีและโครงการ

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

คำขอ

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"

การตอบกลับ

ตัวอย่างการตอบกลับสมมติ

{
  "status": {
    "code": 200,
    "msg": "Project Events",
    "results": 1
  },
  "response": [
    {
      "id": 31,
      "subject": "Example project update",
      "event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
      "type": "comment",
      "value": "Example update",
      "source": "Example source",
      "date_created": "2026-10-23 12:00:00"
    }
  ]
}

โครงการที่มีอยู่แต่ไม่มีเหตุการณ์จะส่งกลับรหัส API 200 รายการว่าง และ status.results เท่ากับ 0 โดยขอผลลัพธ์เรียงตามเวลาที่สร้างจากใหม่ไปเก่า ไม่มีเกณฑ์เรียงลำดับเพิ่มเติมสำหรับรายการที่มีเวลาตรงกัน ไม่มีการแบ่งหน้า เคอร์เซอร์ หรือตัวกรองวันที่

อ่านข้อมูลเหตุการณ์อย่างรอบคอบ

id คือรหัสตัวเลขของแถวเหตุการณ์ subject คือหัวเรื่องที่จัดเก็บไว้ และ date_created คือค่าวันที่/เวลาที่จัดเก็บไว้ จุดปลายทางนี้เก็บสตริงดิบของ event ไว้ตามเดิม และพยายามถอดรหัสคุณสมบัติของสตริงนี้ ได้แก่ type, value และ source หากข้อมูลไม่ใช่ออบเจ็กต์ JSON หรือไม่มีคุณสมบัติใด ฟิลด์ที่แยกวิเคราะห์แล้วซึ่งตรงกับคุณสมบัตินั้นจะเป็นสตริงว่าง

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

ประวัติไม่ได้รับประกันการส่งมอบ

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

ข้อผิดพลาดและข้อจำกัด

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

ผลของการเรียกใช้

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