# getSoftID — cek ID developer

> POST /getSoftID mengembalikan ID developer Anda (softID) dan akumulasi bagi hasil. Sertakan softID di permintaan createTask yang dikirim perangkat lunak Anda untuk pengguna lain agar Anda mendapat bagi hasil.

Source: https://docs.yescaptcha.com/id/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` mengembalikan ID developer Anda (`softID`) dan akumulasi bagi hasil developer Anda (dalam yuan). Saat perangkat lunak atau ekstensi yang Anda kembangkan dipakai orang lain, sertakan ID ini di permintaan `createTask` mereka, dan Anda mendapat bagi hasil dari pengeluaran mereka. Aturan bagi hasil dan penarikan: [Bagi hasil developer](https://docs.yescaptcha.com/id/account/developer.md).

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

## Parameter permintaan

| Field | Tipe | Wajib | Keterangan |
| --- | --- | --- | --- |
| `clientKey` | string | Ya | ClientKey Anda sendiri (developer) |

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

## Hasil yang dikembalikan

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

| Field | Tipe | Keterangan |
| --- | --- | --- |
| `softID` | integer | ID developer Anda |
| `balance` | number | Akumulasi saldo bagi hasil developer, dalam yuan |

## Cara penggunaan

Pada permintaan `createTask` yang dikirim pengguna perangkat lunak Anda, tambahkan field tingkat atas `softID`:

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

> **Perhatian:** Letakkan `softID` di tingkat atas body permintaan, sejajar dengan `clientKey` dan `task`, dengan huruf besar-kecil yang persis sama. Jika diletakkan di dalam `task`, field ini tidak berlaku.

`clientKey` adalah ClientKey milik pengguna sendiri, dan poin yang dipotong adalah poin pengguna; `softID` adalah ID developer Anda.