Kiểm tra số dư - OMOCaptcha

Lấy nhanh số dư hiện tại của tài khoản, gồm cả số dư khuyến mại.

Request

POST https://api.omocaptcha.com/v2/getBalance
Content-Type: application/json

Body Parameters

Tham số	Kiểu	Bắt buộc	Mô tả
`clientKey`	`String`	✅	API key của tài khoản

{
  "clientKey": "OMO_API_KEY"
}

Response

{
  "errorId": 0,
  "errorCode": "",
  "errorDescription": "",
  "balance": "50.00000",
  "voucherBalance": "40.60000"
}

{
  "errorId": 0,
  "errorCode": "",
  "errorDescription": "",
  "balance": "50.00000",
  "voucherBalance": "40.60000",
  "quantity": "1006190"
}

{
  "errorId": 1,
  "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
  "errorDescription": "API key does not exist"
}

Giải thích các trường

Trường	Kiểu	Mô tả
`errorId`	integer	`0` = thành công, `1` = lỗi nghiệp vụ
`errorCode`	`String`	Mã lỗi (rỗng nếu thành công)
`errorDescription`	`String`	Mô tả chi tiết lỗi
`balance`	`String`	Số dư chính (USD, kiểu chuỗi để giữ độ chính xác thập phân)
`voucherBalance`	`String`	Số dư khuyến mại. Khi `balance` không đủ, hệ thống sẽ tự động dùng số dư này
`quantity`	`String`	Chỉ xuất hiện khi `clientKey` là tokenPackage dạng `PKG_...` — số lượt giải còn lại của gói

Xem Bảng mã lỗi để biết danh sách đầy đủ các errorCode.

Ví dụ sử dụng

curl -X POST https://api.omocaptcha.com/v2/getBalance \
  -H "Content-Type: application/json" \
  -d '{"clientKey": "OMO_API_KEY"}'

const res = await fetch("https://api.omocaptcha.com/v2/getBalance", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ clientKey: "OMO_API_KEY" })
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://api.omocaptcha.com/v2/getBalance",
    json={"clientKey": "OMO_API_KEY"}
)
print(res.json())