Tra cứu thông tin định tuyến

Yêu cầu thông tin định tuyến cho một số điện thoại Bắc Mỹ. Dùng thông tin này để diễn giải dữ liệu định tuyến/nhà mạng hiện có, không dùng làm bằng chứng về danh tính thuê bao, quyền sở hữu, khả năng liên lạc hoặc việc số đó có sẵn để mua hay không. Một lần tra cứu có thể khiến tài khoản của bạn bị tính phí.

Yêu cầu

Sử dụng tài khoản API đã được kích hoạt cùng địa chỉ IP nguồn được phép của tài khoản đó. Cung cấp đầy đủ số điện thoại chỉ bằng chữ số, bao gồm mã quốc gia 1. Ví dụ sử dụng các biến môi trường và một số điện thoại giả định. Bộ xử lý không chuẩn hóa dấu câu; hãy kiểm tra tính hợp lệ của dữ liệu đầu vào trước khi gửi.

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

Phản hồi

Chỉ minh họa một số trường được chọn; các trường có sẵn phụ thuộc vào nguồn dữ liệu và loại số điện thoại.

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

Tra cứu tiêu chuẩn chuyển tên các trường trả về thành chữ thường. Tùy nguồn dữ liệu, kết quả có thể chứa các trường về nhà mạng, trung tâm tính cước, vị trí và khu vực tài phán. Phản hồi không phải là hồ sơ thuê bao đầy đủ với cấu trúc cố định. Cờ local có thể là số 1 hoặc chuỗi 0. Bộ xử lý tính ported bằng cách so sánh số định tuyến trả về với số điện thoại được cung cấp; không được diễn giải giá trị này là lịch sử chuyển mạng giữ số đầy đủ đã được xác minh.

Giá và việc thử lại

Bộ xử lý đã được rà soát trừ $0.00025 từ tài khoản khi đi đến nhánh hoàn tất và ghi nhận lần tra cứu. Chi phí trả về thường là một chuỗi có chứa ký hiệu đô la, thay vì chỉ là một giá trị số. Không có khóa bảo đảm tính lũy đẳng nào được cung cấp. Gửi lại một yêu cầu có thể phát sinh thêm một khoản phí.

Đối với tài khoản trả trước, mã nguồn kiểm tra số dư tối thiểu là 0.00025. Thông báo số dư không đủ hiện đề cập đến $5, không khớp với ngưỡng đó. Hãy hiểu lỗi này là yêu cầu bị từ chối do số dư và kiểm tra số tiền trong tài khoản trước khi thử lại.

Lỗi và trường hợp thành công nhưng kết quả chưa đầy đủ

Đọc cả trạng thái HTTP lẫn status.code/status.msg trong JSON. Kết quả tra cứu tiêu chuẩn rỗng trả về mã API 404. Mã API 403 có thể cho biết số dư trả trước không đủ.

Một nhánh xử lý lỗi hiện tại đối với số miễn cước vẫn có thể trừ tiền tra cứu và báo mã API 200 mà không có các trường định tuyến hữu ích; thông tin chi phí của kết quả đó có thể không đầy đủ. Vì vậy, chỉ riêng mã 200 không chứng minh rằng kết quả tra cứu có thể sử dụng được. Hãy kiểm tra tính hợp lệ của các trường mà ứng dụng cần, đối chiếu các khoản phí chưa rõ với hồ sơ thanh toán của tài khoản và liên hệ bộ phận hỗ trợ khi kết quả không đầy đủ.

Trong phần triển khai đã được rà soát, cách xử lý số miễn cước khác nhau tùy độ dài dữ liệu đầu vào. Nên cung cấp đầy đủ các chữ số theo định dạng quốc tế và xác nhận với bộ phận hỗ trợ về phạm vi hỗ trợ số miễn cước mà bạn cần. Không tự động thử lại khi kết quả sai định dạng hoặc không đầy đủ, và không dựa vào tra cứu định tuyến để quyết định rằng việc gọi một số là an toàn hoặc được phép.