ตรวจสอบความครอบคลุมของข้อมูลการจัดสรรหมายเลขในอเมริกาเหนือ

ตรวจสอบความครอบคลุมของตารางการจัดสรร

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

คำขอ

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

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

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

การตอบกลับ

ค่าในฟิลด์เป็นเพียงตัวอย่างประกอบเท่านั้น ไม่ใช่ผลลัพธ์จากตารางการจัดสรรที่ใช้งานจริง

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}

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

ข้อผิดพลาด

อ่านค่า status.code ใน JSON แทนการอาศัยสถานะ HTTP 200 เพียงอย่างเดียว รหัส API 404 พร้อมข้อความ Not part of NANPA หมายความว่าไม่พบเลขนำหน้าที่ตรงกันในตารางที่บริการใช้ ไม่ใช่ข้อวินิจฉัยชี้ขาดจากหน่วยงานกำกับดูแลการกำหนดหมายเลขระดับโลก รหัส API 500 ใช้เมื่อจำนวนหลักไม่ถูกต้องหรือไม่ได้ระบุหมายเลข

ค่าใช้จ่ายและขั้นตอนถัดไป

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