# getSoftID – Truy vấn ID nhà phát triển

> POST /getSoftID trả về ID nhà phát triển (softID) và tổng số tiền chia sẻ doanh thu đã tích lũy của bạn; đặt softID vào yêu cầu createTask khi người khác dùng phần mềm của bạn để nhận phần chia sẻ.

Source: https://docs.yescaptcha.com/vi/api/get-soft-id/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/api/get-soft-id/

`getSoftID` trả về ID nhà phát triển (`softID`) và tổng số tiền chia sẻ doanh thu cho nhà phát triển đã tích lũy (đơn vị: nhân dân tệ, ¥). Khi người khác dùng phần mềm hoặc tiện ích bạn phát triển, hãy thêm ID này vào yêu cầu `createTask` của họ để nhận phần chia sẻ theo mức chi tiêu của họ. Quy tắc chia sẻ và cách rút tiền xem tại [Chia sẻ doanh thu cho nhà phát triển](https://docs.yescaptcha.com/vi/account/developer.md).

- POST `https://api.yescaptcha.com/getSoftID` (Endpoint quốc tế)
- POST `https://cn.yescaptcha.com/getSoftID` (Endpoint Trung Quốc)

## Tham số yêu cầu

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `clientKey` | string | Có | `clientKey` của chính bạn (nhà phát triển) |

```json
{
  "clientKey": "YOUR_CLIENT_KEY"
}
```

## Kết quả trả về

```json
{
  "errorId": 0,
  "softID": 3,
  "balance": 0.004
}
```

| Trường | Kiểu | Mô tả |
| --- | --- | --- |
| `softID` | integer | ID nhà phát triển của bạn |
| `balance` | number | Số dư chia sẻ doanh thu cho nhà phát triển đã tích lũy, đơn vị là nhân dân tệ (¥) |

## Cách sử dụng

Trong yêu cầu `createTask` do người dùng phần mềm của bạn gửi, thêm trường `softID` ở cấp cao nhất:

```json
{
  "clientKey": "THE_USERS_CLIENT_KEY",
  "task": {
    "type": "ImageToTextTaskOcrBase",
    "body": "BASE64_IMAGE"
  },
  "softID": 3
}
```

> **Chú ý:** `softID` phải nằm ở cấp cao nhất của nội dung yêu cầu, ngang hàng với `clientKey` và `task`, viết hoa/thường đúng như trên; đặt bên trong `task` sẽ không có hiệu lực.

`clientKey` là khóa của chính người dùng, nên điểm được trừ từ tài khoản của người dùng; `softID` là ID nhà phát triển của bạn.