ค้นหาชื่อผู้โทร

ค้นหาชื่อผู้โทร

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

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

คำขอ

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

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

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

การตอบกลับ

ค่าต่าง ๆ มีไว้เพื่อเป็นตัวอย่างเท่านั้น ค่าใช้จ่ายนี้ไม่ใช่ใบเสนอราคา

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

การเรียกเก็บเงินและการกระทบยอด

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

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

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

ข้อผิดพลาดและการลองใหม่

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

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

การดำเนินการอื่นเกี่ยวกับหมายเลข

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