Tra cứu tên người gọi

Tra cứu tên người gọi

Lấy kết quả tên người gọi hiện có cho một số điện thoại. Đây là thao tác tra cứu trên hệ thống vận hành thực tế và có thể phát sinh phí trên tài khoản của bạn, kể cả khi kết quả được lấy từ bộ nhớ đệm của dịch vụ. Thao tác này không thay đổi tên hiển thị khi gọi đi của số điện thoại mà bạn sở hữu.

Tên được trả về không xác minh danh tính, quyền sở hữu hay quyền gọi điện. Tên có thể bị thiếu, lỗi thời, viết tắt, là nhãn địa lý hoặc được thay bằng số điện thoại.

Yêu cầu

Sử dụng tài khoản API đã được kích hoạt của bạn từ địa chỉ IP nguồn được cho phép. Lưu thông tin xác thực trong kho lưu trữ bí mật phía máy chủ. Ví dụ sử dụng biến môi trường và một số điện thoại Bắc Mỹ giả định; không đặt thông tin xác thực trong URL hoặc mã trình duyệt công khai.

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

Cung cấp đầy đủ số điện thoại dưới dạng các chữ số, bao gồm mã quốc gia, ví dụ mười một chữ số bắt đầu bằng 1 đối với Bắc Mỹ. Không trông chờ trình xử lý tự chuẩn hóa dấu câu hoặc dấu cộng. Không cần nội dung yêu cầu hay bộ chọn khu vực. Xác nhận với MultiTEL về phạm vi hỗ trợ cho mục đích sử dụng dự kiến của bạn.

Phản hồi

Các giá trị chỉ mang tính minh họa; chi phí này không phải là báo giá.

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

Tính phí và đối soát

Kết quả có tên được tính phí theo giá CNAM đã cấu hình cho tài khoản. Tra cứu lặp lại hoặc tra cứu từ bộ nhớ đệm có thể phát sinh thêm phí; không có khóa bảo đảm tính lũy đẳng được cung cấp. Kiểm tra mức giá hiện tại của tài khoản trước khi bật tra cứu tự động.

Có một hạn chế đã biết của phản hồi khi tên trong bộ nhớ đệm để trống: trình xử lý có thể trả về mã API 200 với tên trống, chi phí khác không và số dư tính toán đã giảm, mặc dù nhánh xử lý đó không trừ tiền tài khoản. Không chỉ dựa vào phản hồi đó để kết luận đã phát sinh phí. Hãy đối soát với hồ sơ tính phí của tài khoản và kết quả mới từ thao tác tra cứu số dư, đồng thời liên hệ bộ phận hỗ trợ nếu kết quả không rõ ràng.

Bước kiểm tra trả trước hiện yêu cầu số dư ít nhất 0.004 trước khi tra cứu, không phụ thuộc vào giá đã cấu hình cho mỗi lần truy vấn. Tài khoản bị vô hiệu hóa chức năng mua cũng bị từ chối. Các bước kiểm tra đó không biến điểm cuối này thành API báo giá hay giới hạn chi tiêu.

Lỗi và thử lại

Kiểm tra cả trạng thái HTTP và status.code/status.msg trong JSON. Mã API 403 có thể có nghĩa là số dư trả trước không đủ, việc mua bị cấm, có vấn đề về quyền truy cập của tài khoản hoặc không tìm thấy tên người gọi. Luồng xử lý không tìm thấy tên có thể trả mã dưới dạng chuỗi. Hãy xem thông báo thay vì coi mọi mã 403 đều là do thông tin xác thực không hợp lệ. Xung đột cấu hình có thể trả về mã API 500.

Tình trạng hết thời gian chờ có thể xảy ra sau một lần tra cứu có tính phí. Chỉ thử lại với số lần giới hạn và khoảng chờ tăng dần khi phù hợp với ứng dụng của bạn, đồng thời đối soát những lần thực hiện chưa rõ kết quả trước. Không liên tục thử lại đối với số điện thoại bị từ chối hoặc lỗi về quyền truy cập/số dư tài khoản. Bộ nhớ đệm phản hồi trong ứng dụng của bạn có thể giảm các yêu cầu lặp lại, tùy theo thỏa thuận và yêu cầu về độ chính xác của bạn.

Các thao tác khác với số điện thoại

Thao tác đọc này tách biệt với việc cập nhật tên hiển thị khi gọi đi/LIDB, đăng danh bạ hoặc đăng ký người gọi. Các thao tác đó có các trường bắt buộc, quyền thực hiện và phí riêng. Sử dụng phạm vi phân bổ số để kiểm tra bảng đầu số hoặc tìm kiếm số điện thoại để xem các số có thể đặt mua. Không thao tác nào trong số này xác nhận người gọi đúng là người mà họ tự nhận.