# getSoftID — consultar tu ID de desarrollador

> POST /getSoftID devuelve tu ID de desarrollador (softID) y la participación del desarrollador acumulada. Incluye el softID en las solicitudes createTask que envía tu software para otros usuarios y obtendrás una participación.

Source: https://docs.yescaptcha.com/es/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` devuelve tu ID de desarrollador (`softID`) y la participación del desarrollador acumulada (en yuanes). Cuando otras personas usan tu software o extensión, incluye este ID en sus solicitudes `createTask` y recibirás una participación de lo que gasten. Reglas y retiros: [Participación del desarrollador](https://docs.yescaptcha.com/es/account/developer.md).

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

## Parámetros de la solicitud

| Campo | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `clientKey` | string | Sí | Tu propio ClientKey (el del desarrollador) |

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

## Respuesta

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

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `softID` | integer | Tu ID de desarrollador |
| `balance` | number | Participación del desarrollador acumulada, en yuanes |

## Cómo usarlo

En las solicitudes `createTask` que envían los usuarios de tu software, añade el campo `softID` en el nivel superior:

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

> **Precaución:** Coloca `softID` en el nivel superior del cuerpo de la solicitud, al mismo nivel que `clientKey` y `task`, y respeta exactamente las mayúsculas y minúsculas. Dentro de `task` no tiene efecto.

`clientKey` es el ClientKey del propio usuario y los puntos se cobran al usuario; `softID` es tu ID de desarrollador.