นักพัฒนา

GET/v3/lnp/project/{uniqueid}/numbers

แสดงรายการหมายเลขในโครงการย้ายหมายเลข

อ่านสถานะ ความคิดเห็น และข้อมูลกำหนดการโอนย้ายที่จัดเก็บไว้ของแต่ละหมายเลข

ในหน้านี้
  1. การเข้าถึงบัญชีและโครงการ
  2. คำขอ
  3. การตอบกลับ
  4. ฟิลด์หมายเลข
  5. ลำดับและการติดตาม
  6. ทำความเข้าใจสถานะการย้ายหมายเลข
  7. ข้อผิดพลาดและข้อจำกัด
  8. ผลกระทบ

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

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

คำขอ

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

การตอบกลับ

ตัวอย่างการตอบกลับที่ใช้ข้อมูลสมมติ

{
  "status": {
    "code": 200,
    "msg": "Project Numbers",
    "results": 1
  },
  "response": [
    {
      "id": 21,
      "number": "12025550123",
      "status": 0,
      "status_str": "Pending",
      "isocode": "US",
      "updated": "2026-10-23 12:00:00",
      "foc": "",
      "comment": "Example customer-visible note",
      "date_created": "2026-10-23 12:00:00",
      "date_completed": ""
    }
  ]
}

response เป็นรายการ โครงการที่มีอยู่แต่ไม่มีหมายเลขจะส่งรายการว่างกลับมาพร้อมรหัส API 200 และ status.results เท่ากับ 0 ส่วนโครงการที่ไม่มีอยู่จะส่งรหัส API 404 กลับมา

ฟิลด์หมายเลข

ฟิลด์หมายเลขที่ย้าย
ฟิลด์ความหมาย
id, number, isocodeID แถวแบบตัวเลข ข้อความหมายเลขโทรศัพท์ที่จัดเก็บ และรหัสประเทศ ID แถวไม่ใช่ ID โครงการ
status, status_strสถานะแบบตัวเลขและป้ายกำกับที่รู้จักของสถานะนั้น
focค่ากำหนดการยืนยันคำสั่งอย่างแน่นอนที่จัดเก็บไว้ ค่านี้อาจว่าง ตัวจัดการไม่ได้แปลงค่าเป็นเขตเวลาหรือรูปแบบเวลาประทับที่ระบุไว้ในเอกสาร
updated, date_created, date_completedค่าการอัปเดต การสร้าง และการเสร็จสมบูรณ์ที่จัดเก็บไว้ จัดการค่าว่างอย่างชัดเจน อย่าสันนิษฐานว่าเป็น ISO8601 หรืออนุมานเขตเวลาจากตัวอย่างสมมติ
commentความคิดเห็นที่จัดเก็บไว้สำหรับแสดงแก่ลูกค้า แสดงเป็นข้อความ ไม่ใช่ HTML ที่เรียกใช้งานได้

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

ลำดับและการติดตาม

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

ทำความเข้าใจสถานะการย้ายหมายเลข

ค่าสถานะหมายเลขที่รู้จัก
ค่าป้ายกำกับ
0Pending
1In Progress
2Completed
9Rejected

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

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

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

ผลกระทบ

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