Kiểm tra tồn kho di động cho một tổng đài

Chọn một tiền tố được hỗ trợ

Sử dụng một tiền tố di động riêng lẻ hiện hành từ kết quả khám phá. Endpoint này dành cho các tổng đài NANPA: NPA xác định mã vùng, và NXX xác định tổng đài. Tiền tố chỉ có mã vùng thì quá rộng. Đừng gửi các ID hiển thị theo nhóm hoặc suy luận rằng một quốc gia khác được hỗ trợ chỉ vì tiền tố của quốc gia đó có đủ chữ số.

Sử dụng số lượng như một gợi ý

Đọc response.count, với response.npa và response.nxx xác định tổng đài. Đây là ảnh chụp nhanh của dịch vụ phủ sóng, không phải số lượng tồn kho được giữ cho tài khoản của bạn. Hãy xác nhận các số thực tế, báo giá áp dụng và mọi yêu cầu đăng ký trước khi đặt hàng. Số lượng trả về thành công không bao giờ cho phép mua hàng.

Phân biệt tồn kho bằng không với tra cứu thất bại

Số lượng bằng không trả về thành công khác với lỗi API. Hãy kiểm tra status.code và status.msg cũng như trạng thái HTTP. Hãy coi thời gian chờ hoặc tra cứu thất bại là khả dụng không xác định và thử lại sau với khoảng chờ giữa các lần thử (backoff).

Yêu cầu

Sử dụng thông tin xác thực tài khoản API đã kích hoạt của bạn qua HTTPS. Chứng thực Basic và mã bearer của tài khoản API đã kích hoạt được hỗ trợ; các hạn chế tài khoản vẫn áp dụng.

GET với định danh tiền tố trong đường dẫn URL. Không có tham số truy vấn hay phần thân nào được ghi lại.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

Phản hồi

Hãy kiểm tra status.code trong phần thân JSON cũng như trạng thái HTTP. Một response thành công có status.code 200 và status.msg Results. response là một đối tượng, không phải danh sách: count là ảnh chụp nhanh tồn kho dạng số nguyên; npa và nxx là chuỗi ba ký tự. status.results không xuất hiện cho đối tượng kết hợp này. Số lượng bằng 0 nghĩa là tra cứu phủ sóng không tìm thấy tổng đài khớp hoặc trả về tồn kho bằng không; điều này không chứng minh rằng tất cả nhà cung cấp hay các tuyến khám phá khác đều không có số.

Hình dạng phản hồi mang tính minh họa; không phải dữ liệu tài khoản thực hay báo giá hiện hành.

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

Lỗi

• 404: Nhà cung cấp bị vô hiệu hóa: khả năng phủ sóng tồn kho di động không có sẵn trên dịch vụ.
• 404: ID tiền tố không hợp lệ: hãy lấy một ID tiền tố riêng lẻ hiện hành từ kết quả khám phá.
• 404: Tiền tố không hợp lệ: tiền tố được lưu không chứa đủ chữ số cho tra cứu NPA/NXX.
• 500: Phủ sóng tồn kho thất bại: tra cứu thượng nguồn không trả về kết quả phủ sóng thành công. Hãy thử lại sau với khoảng chờ giữa các lần thử (backoff); một lỗi không phải là số lượng tồn kho bằng không.

Tính khả dụng và tác dụng phụ

• Thao tác này kiểm tra tồn kho và không đặt hàng, không đặt trước số hay ghi nợ khoản mua hàng.
• Tồn kho có thể thay đổi ngay lập tức. Số lượng phủ sóng không được điều chỉnh để hứa hẹn khả năng mua theo tài khoản hay độ dài giống với phản hồi tìm kiếm số tiếp theo.
• Một lượt tra cứu sẽ liên hệ dịch vụ phủ sóng và có thể mất thời gian. Đừng thăm dò lặp đi lặp lại từng tiền tố, hay coi thời gian chờ/lỗi là tồn kho bằng không thành công.