# getSoftID 查询开发者 ID

> POST /getSoftID 查询你的开发者 ID（softID）和累计分成金额；把 softID 放进别人使用你软件时的 createTask 请求，就能得到分成。

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

`getSoftID` 返回你的开发者 ID（`softID`）和累计的开发者分成金额（元）。你开发的软件或插件给别人用时，在他们的 `createTask` 请求里带上这个 ID，就能按他们的消费得到分成。分成规则和提现见 [开发者分成](https://docs.yescaptcha.com/zh/account/developer/)。

- POST `https://api.yescaptcha.com/getSoftID` (国际节点)
- POST `https://cn.yescaptcha.com/getSoftID` (国内节点)

## 请求参数

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `clientKey` | string | 是 | 你自己（开发者）的账户密钥 |

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

## 返回结果

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `softID` | integer | 你的开发者 ID |
| `balance` | number | 累计的开发者分成余额，单位是元 |

## 怎么使用

在使用你软件的用户发出的 `createTask` 请求里，加上顶层字段 `softID`（和 `clientKey`、`task` 同级，注意大小写）：

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

`clientKey` 是使用者自己的密钥，扣的是使用者的点；`softID` 是你的开发者 ID。