Đọc gói giá số đã lưu

Đọc gói giá đã lưu

Tra cứu các hàng giá đã lưu cho tài khoản API của bạn sau khi duyệt các số điện thoại khả dụng. Hãy dùng uuid của tùy chọn giá, lấy từ danh sách price của số đã chọn, chứ không phải số điện thoại, ID tiền tố hay ID khu vực của số đó. Hãy giữ số đã chọn và tùy chọn giá đi cùng nhau.

Đây là thao tác tra cứu tương thích đối với giá đã lưu. Thao tác này không làm mới tình trạng khả dụng hoặc giá, không giữ chỗ số, không đặt hàng và không bảo đảm số tiền của một giao dịch mua trong tương lai. Hãy xem lại tùy chọn giá được trả về bằng một lần tìm kiếm số mới trước khi đặt hàng.

Yêu cầu

Hãy dùng tài khoản API đã được bật của bạn qua HTTPS từ một địa chỉ IP được phép. Đặt PRICE_ID thành đúng ID tùy chọn giá mà bạn đã nhận. Phương thức này đọc một đối số đường dẫn và không đọc tham số nội dung (body), ngày hay phân trang.

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

Chính tài khoản đã nhận được tùy chọn giá phải thực hiện thao tác tra cứu này. Không tự tạo ID, không dùng số hàng trong cơ sở dữ liệu và không thay thế bằng lựa chọn của tài khoản khác. Phương thức kế thừa này chỉ khớp theo ID giá hiển thị.

Phản hồi

Ví dụ giả định sau đây chỉ hiển thị một số trường dành cho khách hàng. Phản hồi thực tế trả về các hàng đã lưu đầy đủ và có thể bao gồm thêm siêu dữ liệu về tài khoản, nhà cung cấp và giá nội bộ. Hãy giữ toàn bộ phản hồi trên máy chủ của bạn và chỉ hiển thị những giá trị dành cho khách hàng mà ứng dụng của bạn cần.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "visible_uuid": "PRICE_FROM_SEARCH",
      "setup_price": "2.00",
      "monthly_price": "4.50",
      "per_minute": "0.0100",
      "free_minutes": "100",
      "channels": "2"
    }
  ]
}

response là một danh sách, ngay cả khi chỉ có một hàng. status.results đếm số hàng được trả về. Các giá trị số từ cơ sở dữ liệu có thể là chuỗi. Điểm cuối này không thêm trường tiền tệ và không quy đổi tiền tệ; hãy xác nhận đơn vị tiền tệ thanh toán của tài khoản thay vì suy ra từ ví dụ này.

Các trường giá

Xử lý nhiều hàng khớp

Một lần tra cứu có thể trả về nhiều hơn một hàng đã lưu. Phương thức này không bảo đảm thứ tự sắp xếp, không chọn hàng mới nhất và không lọc theo số/tiền tố. Không được âm thầm chọn hàng đầu tiên hay hàng cuối cùng. Hãy so sánh ngữ cảnh được trả về với số đã chọn ban đầu và tùy chọn giá; nếu vẫn không rõ ràng hoặc đã cũ, hãy tìm kiếm số lại thay vì coi phản hồi này là báo giá đặt hàng.

Quy trình xem lại đơn hàng của cổng thông tin thực hiện thêm các bước chọn lựa và kiểm tra tính hợp lệ. Không giả định rằng thao tác tra cứu kế thừa này thực hiện những kiểm tra đó hoặc chấp nhận mọi mã định danh mà cổng thông tin chấp nhận.

Phản hồi trống và lỗi

Nếu không có hàng đã lưu nào khớp, trình xử lý hiện tại không phát ra kết quả JSON nào và cũng không có phản hồi không-tìm-thấy rõ ràng. Nội dung phản hồi trống không có nghĩa là giá bằng không, gói khả dụng hay một lần tra cứu thành công đã được xác nhận. Hãy kiểm tra cả phản hồi HTTP lẫn cấu trúc JSON; không đặt hàng dựa trên dữ liệu giá bị thiếu hoặc không phân tích được.

Lỗi xác thực, hạn chế theo địa chỉ IP nguồn và sự cố cơ sở dữ liệu cũng có thể ngăn bạn nhận được phản hồi sử dụng được. Không có bao bọc lỗi riêng của trình xử lý cho ngoại lệ cơ sở dữ liệu. Hãy làm mới lựa chọn của bạn hoặc liên hệ bộ phận hỗ trợ khi thao tác tra cứu đã xác thực vẫn không khả dụng.

Tác động và giới hạn

Thao tác tra cứu đã được xem xét chỉ thực hiện một truy vấn đọc và không chứa bất kỳ thao tác ghi nợ, mua, giữ chỗ hay làm mới giá từ nhà cung cấp nào. Việc đọc giá đã lưu không xác lập tình trạng tồn kho hiện tại, phê duyệt theo quy định, quyền mua của tài khoản hay số tiền thanh toán cuối cùng.