การเชื่อมต่อ CNAM

เอกสารอ้างอิง CNAM REST API

ร้องขอชื่อผู้โทรผ่าน HTTPS และจัดการผลลัพธ์ ค่าใช้จ่าย และข้อผิดพลาด

เลือกพฤติกรรมการค้นหา

ระดับ	ราคาสาธารณะต่อการสืบค้น	การทำงาน
Starter	US$0.0026	ใช้ข้อมูลชื่อผู้โทรที่เป็นกรรมสิทธิ์และข้อมูลที่แคชไว้
Standard	US$0.0037	ค้นหาผ่านเครือข่ายแบบเรียลไทม์สำหรับทุกการสืบค้น
Mixed	US$0.004	ลองค้นหาแบบเรียลไทม์ก่อน แล้วย้อนกลับไปใช้ข้อมูลของ Starter เมื่อไม่พบชื่อ

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

ส่งการค้นหาที่ผ่านการพิสูจน์ตัวตน

ปลายทาง (Endpoint): GET https://api.multitel.net/v3/cnam/NUMBER ใช้หมายเลขโทรศัพท์รูปแบบสากลที่รวมรหัสประเทศ โดยระบุเฉพาะตัวเลข ไม่มีเครื่องหมายวรรคตอนหรือเครื่องหมายบวกนำหน้า ดำเนินการนี้จากเซิร์ฟเวอร์แอปพลิเคชันของคุณโดยใช้ข้อมูลรับรอง API ที่ได้รับอนุมัติ

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  "https://api.multitel.net/v3/cnam/12025550123"

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

คู่มือการพิสูจน์ตัวตน API และคำขอแรก

อ่านการตอบกลับ JSON

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

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE CALLER",
    "cost": "0.004",
    "balance": "24.9960"
  }
}

status.code: รหัสผลลัพธ์ของแอปพลิเคชัน ให้ปรับค่าสตริง/ตัวเลขให้เป็นรูปแบบเดียวกันก่อนเปรียบเทียบกับ 200
status.msg: ข้อความผลลัพธ์หรือการปฏิเสธที่มาพร้อมกัน
response.number: หมายเลขที่สืบค้น
response.name: ชื่อผู้โทรที่มีอยู่
response.cost: ค่าใช้จ่ายที่รายงานสำหรับการสืบค้นนี้ ให้ถือเป็นจำนวนเงินทศนิยม
response.balance: ยอดคงเหลือของบัญชีที่รายงาน เมื่อมีข้อมูลนี้

ผลลัพธ์ที่ไม่มีชื่อและข้อผิดพลาด

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

ตรวจสอบทั้งสถานะ HTTP และ status ใน JSON ก่อนเข้าถึง response.name ออบเจ็กต์การตอบกลับอาจไม่ปรากฏเมื่อเกิดข้อผิดพลาด การไม่มีชื่อไม่ควรขัดขวางการกำหนดเส้นทางการโทรตามปกติ

การเรียกเก็บเงิน การลองซ้ำ และความแตกต่างจากการอัปเดต Caller ID

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

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

คู่มือการเชื่อมต่อ CNAM ของบัญชี ขอความช่วยเหลือด้านการเชื่อมต่อ