ตรวจสอบสินค้าคงเหลือมือถือสำหรับหนึ่งชุมสายโทรศัพท์

เลือกคำนำหน้าที่รองรับ

ใช้คำนำหน้ามือถือปัจจุบันที่เป็นรายการแยกแต่ละรายการจากผลการค้นพบ endpoint นี้มีไว้สำหรับชุมสายโทรศัพท์ของ NANPA: NPA ระบุรหัสพื้นที่ และ NXX ระบุชุมสายโทรศัพท์ คำนำหน้าที่มีเพียงรหัสพื้นที่ถือว่ากว้างเกินไป อย่าส่ง ID แสดงผลแบบกลุ่ม หรือสรุปว่าประเทศอื่นได้รับการรองรับเพียงเพราะคำนำหน้าของประเทศนั้นมีตัวเลขเพียงพอ

ใช้จำนวนนับเป็นเพียงคำใบ้

อ่าน response.count, โดยมี response.npa และ response.nxx ระบุชุมสายโทรศัพท์ นี่คือภาพรวม ณ ช่วงเวลาหนึ่งของบริการครอบคลุม ไม่ใช่สินค้าคงเหลือที่ถือไว้สำหรับบัญชีของคุณ กรุณายืนยันหมายเลขจริง ใบเสนอราคาที่ใช้บังคับ และข้อกำหนดการขึ้นทะเบียนใด ๆ ก่อนสั่งซื้อ จำนวนนับที่สำเร็จไม่เคยอนุญาตให้ซื้อ

แยกแยะสินค้าคงเหลือศูนย์ออกจากการค้นหาที่ล้มเหลว

จำนวนนับศูนย์ที่สำเร็จแตกต่างจากข้อผิดพลาดของ API กรุณาตรวจสอบ status.code และ status.msg รวมถึงสถานะ HTTP ด้วย ให้ถือว่าการหมดเวลาหรือการค้นหาที่ล้มเหลวเป็นความพร้อมใช้งานที่ไม่ทราบแน่ชัด แล้วลองใหม่ภายหลังโดยเว้นช่วงระหว่างการลองใหม่ (backoff)

คำขอ

ใช้ข้อมูลรับรองบัญชี API ที่เปิดใช้งานของคุณผ่าน HTTPS การรับรองความถูกต้องแบบ Basic และโทเคน bearer ของบัญชี API ที่เปิดใช้งานได้รับการรองรับ ข้อจำกัดของบัญชียังคงมีผลใช้บังคับ

GET โดยมีตัวระบุคำนำหน้าอยู่ในส่วนเส้นทางของ URL ไม่มีพารามิเตอร์ query หรือ body ที่บันทึกไว้

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

การตอบกลับ

ตรวจสอบ status.code ในเนื้อหา JSON รวมถึงสถานะ HTTP ด้วย response ที่สำเร็จจะมี status.code เป็น 200 และ status.msg เป็น Results response เป็นออบเจ็กต์ ไม่ใช่รายการ: count คือภาพรวมสินค้าคงเหลือชนิดจำนวนเต็ม npa และ nxx เป็นสตริงสามอักขระ status.results ไม่ปรากฏสำหรับออบเจ็กต์เชื่อมโยงนี้ จำนวนนับเท่ากับ 0 หมายความว่าการค้นหาความครอบคลุมไม่พบชุมสายโทรศัพท์ที่ตรงกันหรือส่งกลับสินค้าคงเหลือศูนย์ ซึ่งไม่ได้พิสูจน์ว่าผู้ให้บริการทั้งหมดหรือเส้นทางค้นพบอื่น ๆ ไม่มีหมายเลข

รูปแบบการตอบกลับเพื่อประกอบการอธิบาย ไม่ใช่ข้อมูลบัญชีจริงหรือใบเสนอราคาปัจจุบัน

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

ข้อผิดพลาด

• 404: ผู้ให้บริการถูกปิดใช้งาน: ความครอบคลุมของสินค้าคงเหลือมือถือไม่พร้อมใช้งานบนบริการนี้
• 404: ID คำนำหน้าไม่ถูกต้อง: กรุณาขอรับ ID ของคำนำหน้าปัจจุบันแต่ละรายการจากการค้นพบ
• 404: คำนำหน้าไม่ถูกต้อง: คำนำหน้าที่จัดเก็บไว้มีตัวเลขไม่เพียงพอสำหรับการค้นหา NPA/NXX
• 500: ความครอบคลุมของสินค้าคงเหลือล้มเหลว: การค้นหาต้นน้ำไม่ได้ส่งกลับผลลัพธ์ความครอบคลุมที่สำเร็จ กรุณาลองใหม่ภายหลังโดยเว้นช่วงระหว่างการลองใหม่ (backoff) ความล้มเหลวไม่ใช่จำนวนสินค้าคงเหลือศูนย์

ความพร้อมใช้งานและผลข้างเคียง

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