# getSoftID — consulter votre ID développeur

> POST /getSoftID renvoie votre ID développeur (softID) et le montant cumulé de votre part développeur ; ajoutez le softID aux requêtes createTask que votre logiciel envoie pour d'autres utilisateurs afin de percevoir une part.

Source: https://docs.yescaptcha.com/fr/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` renvoie votre ID développeur (`softID`) et le montant cumulé de votre part développeur (en yuans). Lorsque d’autres personnes utilisent votre logiciel ou votre extension, ajoutez cet ID à leurs requêtes `createTask` : vous recevez une part de ce qu’elles dépensent. Règles de calcul et retrait : [Part développeur](https://docs.yescaptcha.com/fr/account/developer.md).

- POST `https://api.yescaptcha.com/getSoftID` (Endpoint mondial)
- POST `https://cn.yescaptcha.com/getSoftID` (Endpoint Chine)

## Paramètres de la requête

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `clientKey` | string | Oui | Votre propre ClientKey (celle du développeur) |

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

## Réponse

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

| Champ | Type | Description |
| --- | --- | --- |
| `softID` | integer | Votre ID développeur |
| `balance` | number | Solde cumulé de la part développeur, en yuans |

## Utilisation

Dans les requêtes `createTask` envoyées par les utilisateurs de votre logiciel, ajoutez le champ de premier niveau `softID` :

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

> **Attention:** Placez `softID` au premier niveau du corps de la requête, au même niveau que `clientKey` et `task`, avec exactement la même casse. À l’intérieur de `task`, il n’a aucun effet.

`clientKey` est la ClientKey de l’utilisateur, et les points sont débités de son compte ; `softID` est votre ID développeur.