# getSoftID — запрос ID разработчика

> POST /getSoftID возвращает ваш ID разработчика (softID) и накопленную сумму доли разработчика. Добавьте softID в запросы createTask, которые ваше ПО отправляет от имени других пользователей, чтобы получать долю.

Source: https://docs.yescaptcha.com/ru/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`) и накопленную сумму доли разработчика (в юанях). Когда другие люди используют ваше ПО или расширение, добавляйте этот ID в их запросы `createTask` — вы получаете долю от их расходов. Правила и вывод средств: [Доля разработчика](https://docs.yescaptcha.com/ru/account/developer.md).

- POST `https://api.yescaptcha.com/getSoftID` (Глобальный endpoint)
- POST `https://cn.yescaptcha.com/getSoftID` (Endpoint для Китая)

## Параметры запроса

| Поле | Тип | Обязательное | Описание |
| --- | --- | --- | --- |
| `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 разработчика.