นักพัฒนา

GET/v3/lrn/{number}

ค้นหาข้อมูลการกำหนดเส้นทาง

อ่านข้อมูลการกำหนดเส้นทางที่มี พร้อมจัดการค่าค้นหาและความล้มเหลวบางส่วน

ในหน้านี้
  1. ค้นหาข้อมูลการกำหนดเส้นทาง
  2. คำขอ
  3. การตอบกลับ
  4. ราคาและการลองใหม่
  5. ความล้มเหลวและความสำเร็จที่ได้ผลลัพธ์ไม่ครบถ้วน

ค้นหาข้อมูลการกำหนดเส้นทาง

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

คำขอ

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

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

การตอบกลับ

แสดงเฉพาะบางฟิลด์เพื่อเป็นตัวอย่างเท่านั้น ฟิลด์ที่มีให้ขึ้นอยู่กับแหล่งข้อมูลและประเภทหมายเลข

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

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

ราคาและการลองใหม่

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

สำหรับบัญชีแบบเติมเงิน โค้ดจะตรวจสอบว่ามียอดเงินคงเหลืออย่างน้อย 0.00025 ข้อความแจ้งยอดเงินไม่เพียงพอในปัจจุบันระบุ $5 ซึ่งไม่ตรงกับเกณฑ์ดังกล่าว ให้เข้าใจว่าความล้มเหลวนี้เป็นการปฏิเสธเนื่องจากยอดเงินคงเหลือ และตรวจสอบเงินในบัญชีก่อนลองใหม่

ความล้มเหลวและความสำเร็จที่ได้ผลลัพธ์ไม่ครบถ้วน

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

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

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