Skip to content
Tài liệu tham khảo API
/
Điện thoại đám mây
/
/Account & Quotas

Account & Quotas

Truy vấn số dư ví và hạn mức sử dụng cloud phone.

Operations

Lấy số dư và hạn mức Cloud Phone

Request

Trả về số dư ví của nhóm và hạn mức sử dụng cloud phone.

  • Điều kiện tiên quyết: thành viên gọi cần quyền chi phí. Ví được tra cứu theo nhóm, nên các con số này là của cả nhóm chứ không phải của từng thành viên.
  • Tác động: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn.
  • Đơn vị: balance là số dư ví theo xu, không phải theo đơn vị tiền tệ. remainingDuration là số phút cloud phone còn lại và remainingConcurrency là số suất đồng thời; cả hai đều bị chặn ở 0 thay vì xuống âm.
  • Nội dung: đúng ba con số này. Số tiền bị phong tỏa trong ví, phần chia giữa số phút đã dùng và được tặng, cùng các mốc hết hạn đều tồn tại ở tầng trên nhưng cố ý không được phơi ra ở đây.
  • Lưu ý: lệnh gọi thất bại toàn bộ nếu việc tra cứu ví hoặc tra cứu hạn mức thất bại; nó không bao giờ trả về số liệu một phần.
curl -i -X GET \
  http://127.0.0.1:40000/api/balance

Responses

Request processed; inspect code for the business result

Bodyapplication/json
codeintegerrequired

Business result code; 0 indicates success

Example:0
msgstring or nullrequired

Error message; null when successful

Example:null
requestIdstringrequired

Request ID for troubleshooting

Example:"1d4f3ea968664593860b94b35d4ebf5e"
dataobjectrequired
Response
{
  "code": 0,
  "msg": null,
  "data": {
    "balance": 12500,
    "remainingDuration": "120",
    "remainingConcurrency": 3
  },
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e"
}