Kiểm tra phạm vi bao phủ của bảng phân bổ
Kiểm tra xem số điện thoại Bắc Mỹ có khớp với tiền tố trong bảng phân bổ của MultiTEL hay không, đồng thời lấy thông tin thành phố, tiểu bang và quốc gia tương ứng. Đây là thao tác tra cứu bảng tiền tố. Kết quả không xác nhận rằng thuê bao đang hoạt động, số điện thoại đã được cấp, số đó thuộc tài khoản của bạn hoặc bạn có thể đặt mua số đó.
Yêu cầu
Sử dụng tài khoản API đã được kích hoạt của bạn và địa chỉ IP nguồn được phép. Ví dụ sử dụng thông tin xác thực HTTP Basic từ các biến môi trường và một số điện thoại giả định. Không cần phần thân yêu cầu.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/12025550123Nên dùng số điện thoại Bắc Mỹ gồm mười một chữ số bắt đầu bằng 1. Bộ xử lý loại bỏ các ký tự không phải chữ số và thêm 1 vào đầu dữ liệu nhập gồm mười chữ số. Dữ liệu có số lượng chữ số khác sẽ bị từ chối. Việc chuẩn hóa này không kiểm tra tất cả các quy tắc đánh số Bắc Mỹ, vì vậy kết quả khớp với bảng không có nghĩa là số điện thoại đã được xác thực toàn diện.
Phản hồi
Các giá trị trường chỉ dùng để minh họa; đây không phải là kết quả từ bảng phân bổ thực tế.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| Trường | Ý nghĩa |
|---|---|
| number | Dữ liệu nhập đã được chuẩn hóa, chỉ gồm chữ số. |
| npanxx | Tiền tố đã lưu khớp với số điện thoại. Bộ xử lý ưu tiên tiền tố gồm bảy chữ số chứa mã quốc gia/mã vùng/mã tổng đài và có thể chuyển sang dùng tiền tố gồm bốn chữ số chứa mã quốc gia/mã vùng nếu không tìm thấy tiền tố ưu tiên; đừng mặc định rằng trường này luôn xác định đầy đủ mã tổng đài. |
| city, state, country | Siêu dữ liệu của tiền tố phân bổ khớp với số điện thoại. Các trường này không xác định vị trí thực tế hiện tại của thuê bao hoặc nhà mạng hiện tại sau khi chuyển mạng giữ số. |
Lỗi
Đọc JSON và xem trường status.code thay vì chỉ dựa vào mã HTTP 200. Mã API 404 kèm thông báo Not part of NANPA có nghĩa là không có tiền tố nào khớp trong bảng mà dịch vụ sử dụng; đây không phải là kết luận có tính quyết định của cơ quan quản lý đánh số trên phạm vi toàn cầu. Mã API 500 được dùng khi số lượng chữ số không hợp lệ hoặc thiếu số điện thoại.
Chi phí và các bước tiếp theo
Bộ xử lý đã được rà soát thực hiện truy vấn bảng phân bổ cục bộ và không có thao tác trừ tiền từ tài khoản hay tra cứu bên ngoài. Bộ xử lý này không tính phí tra cứu. Sử dụng tính năng tìm kiếm số có sẵn để tìm các số trong kho có thể đặt mua. Tra cứu tên, tra cứu định tuyến hoặc đặt mua số là những thao tác riêng, có mức giá áp dụng cho tài khoản riêng cho từng thao tác.