# getSoftID – consultar o ID de desenvolvedor

> POST /getSoftID retorna seu ID de desenvolvedor (softID) e o total acumulado da participação do desenvolvedor; inclua o softID nas requisições createTask feitas quando outras pessoas usam seu software para receber a participação.

Source: https://docs.yescaptcha.com/pt/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` retorna seu ID de desenvolvedor (`softID`) e o total acumulado da participação do desenvolvedor (em yuans). Quando outras pessoas usam o software ou a extensão que você desenvolveu, inclua esse ID nas requisições `createTask` delas e você recebe uma participação sobre o que elas gastam. Regras de participação e saque: [Participação do desenvolvedor](https://docs.yescaptcha.com/pt/account/developer.md).

- POST `https://api.yescaptcha.com/getSoftID` (Endpoint global)
- POST `https://cn.yescaptcha.com/getSoftID` (Endpoint China)

## Parâmetros da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `clientKey` | string | Sim | Sua própria `clientKey` (a do desenvolvedor) |

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

## Resposta

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

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `softID` | integer | Seu ID de desenvolvedor |
| `balance` | number | Saldo acumulado da participação do desenvolvedor, em yuans |

## Como usar

Nas requisições `createTask` feitas pelos usuários do seu software, adicione o campo de nível superior `softID`:

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

> **Cuidado:** Coloque `softID` no nível superior do corpo da requisição, ao lado de `clientKey` e `task`, com exatamente esta grafia (maiúsculas e minúsculas). Dentro de `task`, ele não tem efeito.

`clientKey` é a chave do próprio usuário, e os pontos são cobrados dele; `softID` é o seu ID de desenvolvedor.