Liệt kê các quốc gia trong danh mục (định dạng cũ)

Điểm cuối phiên bản cũ này trả về phần thân dạng {"code", "data"} thay vì cấu trúc bao bọc tiêu chuẩn status/response. Điểm cuối này liệt kê các quốc gia được hiển thị và liên kết với danh mục số điện thoại đặc biệt, đồng thời không kiểm tra số lượng số điện thoại còn sẵn.

Đối với các tích hợp mới:

• Dùng GET /v3/getcountries để tìm các quốc gia có số điện thoại còn sẵn.
• Dùng GET /v3/other/{isocode} để xem những loại số điện thoại đặc biệt nào thực sự được cung cấp tại một quốc gia. Một quốc gia được liệt kê ở đây vẫn có thể trả về danh mục trống khi truy vấn điểm cuối đó.

Yêu cầu

Bắt buộc: xác thực HTTP Basic hoặc mã thông báo Bearer (xem phần Xác thực và phản hồi API). Nếu xác thực thất bại, hệ thống trả về HTTP 401 trong cấu trúc bao bọc tiêu chuẩn trước khi thực hiện tra cứu.

GET không có tham số và không có phần thân.

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'

Phản hồi

Phần thân theo định dạng cũ, không có cấu trúc bao bọc tiêu chuẩn: {code: 200, data: [...]}. Không có đối tượng status hay trường msg hoặc results. data liệt kê các quốc gia theo thứ tự không được bảo đảm. Các trường: countrycode (mã gọi quốc gia không có dấu '+'), name, description (có cùng giá trị với name), isocode, latitude và longitude. Không có các trường is_mobile, sms_coverage hoặc next_function. Một quốc gia được liệt kê khi quốc gia đó được hiển thị và liên kết với danh mục số điện thoại đặc biệt. Số lượng số điện thoại còn sẵn không được kiểm tra, vì vậy một quốc gia được liệt kê có thể hiện không có số điện thoại nào còn sẵn. Nếu không có quốc gia nào đáp ứng điều kiện, data có giá trị null.

Cấu trúc phản hồi minh họa; không phải dữ liệu tài khoản thực tế hay báo giá hiện hành.

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

Lỗi

• 401: Thiếu thông tin xác thực hoặc xác thực thất bại. Được gửi với HTTP status 401 trong cấu trúc bao bọc tiêu chuẩn status/response, không phải trong phần thân theo định dạng cũ.

Khả năng cung cấp và tác động phụ

• Chỉ dùng để tra cứu. Không giữ chỗ, đặt mua hay thay đổi bất cứ điều gì.