# getSoftID – Entwickler-ID abfragen

> POST /getSoftID gibt Ihre Entwickler-ID (softID) und die aufgelaufene Entwicklerbeteiligung zurück. Tragen Sie die softID in die createTask-Anfragen ein, die Ihre Software für andere Nutzer sendet, um eine Beteiligung zu erhalten.

Source: https://docs.yescaptcha.com/de/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` gibt Ihre Entwickler-ID (`softID`) und den aufgelaufenen Betrag Ihrer Entwicklerbeteiligung (in Yuan) zurück. Wenn andere Ihre Software oder Erweiterung verwenden, tragen Sie diese ID in deren `createTask`\-Anfragen ein, um an deren Ausgaben beteiligt zu werden. Regeln und Auszahlung: [Entwicklerbeteiligung](https://docs.yescaptcha.com/de/account/developer.md).

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

## Anfrageparameter

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `clientKey` | string | Ja | Ihr eigener ClientKey (als Entwickler) |

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

## Rückgabe

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

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `softID` | integer | Ihre Entwickler-ID |
| `balance` | number | Aufgelaufene Entwicklerbeteiligung in Yuan |

## Verwendung

Fügen Sie in den `createTask`\-Anfragen der Nutzer Ihrer Software das Feld `softID` auf oberster Ebene hinzu:

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

> **Achtung:** Setzen Sie `softID` auf die oberste Ebene des Request-Bodys, auf derselben Ebene wie `clientKey` und `task`, und achten Sie auf exakt dieselbe Groß- und Kleinschreibung. Innerhalb von `task` hat das Feld keine Wirkung.

`clientKey` ist der ClientKey des Nutzers, die Punkte werden dem Nutzer abgezogen; `softID` ist Ihre Entwickler-ID.