# getSoftID 開発者 ID の照会

> POST /getSoftID で開発者 ID(softID)と累計の収益分配額を照会します。他のユーザーがあなたのソフトウェアを使うときの createTask リクエストに softID を含めると、収益分配を受け取れます。

Source: https://docs.yescaptcha.com/ja/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` は、開発者 ID(`softID`)と累計の開発者収益分配額(元)を返します。開発したソフトウェアやプラグインを他のユーザーが使うとき、そのユーザーの `createTask` リクエストにこの ID を含めると、ユーザーの利用額に応じた収益分配を受け取れます。分配ルールと出金については [開発者収益分配](https://docs.yescaptcha.com/ja/account/developer.md) を参照してください。

- POST `https://api.yescaptcha.com/getSoftID` (グローバルエンドポイント)
- POST `https://cn.yescaptcha.com/getSoftID` (中国エンドポイント)

## リクエストパラメータ

| フィールド | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `clientKey` | string | はい | 自分自身(開発者)の `clientKey` |

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

## レスポンス

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

| フィールド | 型 | 説明 |
| --- | --- | --- |
| `softID` | integer | 開発者 ID |
| `balance` | number | 累計の開発者収益分配額。単位は元 |

## 使い方

ソフトウェアを使うユーザーが送る `createTask` リクエストに、トップレベルのフィールド `softID` を追加します。

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

> **注意:** `softID` はリクエストボディのトップレベルに、`clientKey` や `task` と同じ階層で、大文字・小文字を一致させて指定してください。`task` の中に入れても有効になりません。

`clientKey` は利用者自身のキーで、課金されるのは利用者のポイントです。`softID` はあなたの開発者 ID です。