# getSoftID – Geliştirici ID'sini sorgulama

> POST /getSoftID geliştirici ID'nizi (softID) ve biriken gelir payı tutarını döndürür. Yazılımınızın başkaları için gönderdiği createTask isteklerine softID'yi ekleyerek pay kazanırsınız.

Source: https://docs.yescaptcha.com/tr/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`, geliştirici ID’nizi (`softID`) ve biriken geliştirici gelir payı tutarını (CNY) döndürür. Geliştirdiğiniz yazılım veya eklenti başkaları tarafından kullanıldığında, onların `createTask` isteklerine bu ID’yi ekleyin; harcamalarından pay alırsınız. Pay kuralları ve para çekme için: [Geliştirici gelir payı](https://docs.yescaptcha.com/tr/account/developer.md).

- POST `https://api.yescaptcha.com/getSoftID` (Global uç nokta)
- POST `https://cn.yescaptcha.com/getSoftID` (Çin uç noktası)

## İstek alanları

| Alan | Tür | Zorunlu | Açıklama |
| --- | --- | --- | --- |
| `clientKey` | string | Evet | Kendi (geliştiricinin) ClientKey’niz |

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

## Yanıt

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

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `softID` | integer | Geliştirici ID’niz |
| `balance` | number | Biriken geliştirici gelir payı, birim CNY |

## Nasıl kullanılır

Yazılımınızı kullanan kullanıcıların gönderdiği `createTask` isteklerine üst düzey `softID` alanını ekleyin:

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

> **Dikkat:** `softID`, istek gövdesinin en üst düzeyine, `clientKey` ve `task` ile aynı seviyeye, alan adının büyük/küçük harfi birebir aynı olacak şekilde yazılmalıdır. `task` içine konulursa etkili olmaz.

`clientKey` kullanıcının kendi ClientKey’dir ve puan düşümü kullanıcının hesabından yapılır; `softID` ise sizin geliştirici ID’nizdir.