การเข้าถึงบัญชีและโครงการ
ใช้บัญชี 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, isocode | ID แถวแบบตัวเลข ข้อความหมายเลขโทรศัพท์ที่จัดเก็บ และรหัสประเทศ ID แถวไม่ใช่ ID โครงการ |
| status, status_str | สถานะแบบตัวเลขและป้ายกำกับที่รู้จักของสถานะนั้น |
| foc | ค่ากำหนดการยืนยันคำสั่งอย่างแน่นอนที่จัดเก็บไว้ ค่านี้อาจว่าง ตัวจัดการไม่ได้แปลงค่าเป็นเขตเวลาหรือรูปแบบเวลาประทับที่ระบุไว้ในเอกสาร |
| updated, date_created, date_completed | ค่าการอัปเดต การสร้าง และการเสร็จสมบูรณ์ที่จัดเก็บไว้ จัดการค่าว่างอย่างชัดเจน อย่าสันนิษฐานว่าเป็น ISO8601 หรืออนุมานเขตเวลาจากตัวอย่างสมมติ |
| comment | ความคิดเห็นที่จัดเก็บไว้สำหรับแสดงแก่ลูกค้า แสดงเป็นข้อความ ไม่ใช่ HTML ที่เรียกใช้งานได้ |
โครงสร้างการตอบกลับนี้ไม่รวมฟิลด์ที่ใช้เฉพาะเจ้าหน้าที่ internal_comment ซึ่งไม่ได้หมายความว่าการค้นหาหมายเลขเดียวแบบเดิมที่แยกต่างหากจะใช้โครงสร้างการตอบกลับเดียวกัน
ลำดับและการติดตาม
คำสั่งค้นหาเรียงตามเวลาสร้างจากเก่าไปใหม่ แถวที่มีเวลาสร้างเท่ากันไม่มีการรับประกันลำดับเพิ่มเติม ไม่มีการแบ่งหน้า เคอร์เซอร์แบบเพิ่มต่อเนื่อง หรือตัวกรองวันที่ อ่านรายการทั้งหมดเพื่อกระทบยอดโครงการ และอย่าถือว่าจำนวนแถวปัจจุบันเป็นรายการคงที่ถาวร
ทำความเข้าใจสถานะการย้ายหมายเลข
| ค่า | ป้ายกำกับ |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
เก็บสถานะแบบตัวเลขไว้และรองรับค่าที่ไม่รู้จัก เมื่อไม่รู้จักป้ายกำกับ ระบบจะใช้ค่าที่จัดเก็บแทน ไม่ได้รับประกันว่าจะมีป้ายกำกับใหม่ สถานะเสร็จสมบูรณ์หรือวันที่กำหนดไว้ที่จัดเก็บเพียงอย่างเดียวไม่ได้ทดสอบการกำหนดเส้นทางขาเข้าหรือทุกบริการของหมายเลขนั้น
ข้อผิดพลาดและข้อจำกัด
ตรวจสอบทั้งการตอบกลับ HTTP และ status.code/status.msg โครงการที่ไม่มีอยู่ ถูกลบ หรือไม่ได้เป็นของบัญชีจะส่งรหัส API 404 พร้อมข้อความว่าไม่พบโครงการ ข้อจำกัดด้านการยืนยันตัวตนและ IP ต้นทางยังคงมีผล ตัวอย่างไม่ได้ส่งคำขอจริง และการตอบกลับสำเร็จไม่ได้พิสูจน์ว่าผู้ให้บริการเครือข่ายยอมรับหรือดำเนินการโอนย้ายเสร็จแล้ว
ผลกระทบ
ตัวจัดการที่ตรวจสอบจะอ่านเฉพาะโครงการและแถวหมายเลขที่จัดเก็บไว้ การตอบกลับเป็นภาพสถานะ ณ ขณะหนึ่ง ไม่ใช่การยืนยันจากผู้ให้บริการเครือข่ายหรือการทดสอบบริการจริง ไม่เริ่มการย้ายหมายเลข ไม่เปลี่ยนเส้นทาง และไม่หักเงินจากบัญชี