# getSoftID 개발자 ID 조회

> POST /getSoftID로 개발자 ID(softID)와 누적 개발자 수익 배분 금액을 조회해요. 다른 사용자가 내 소프트웨어를 쓸 때 보내는 createTask 요청에 softID를 넣으면 수익을 배분받을 수 있어요.

Source: https://docs.yescaptcha.com/ko/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`는 개발자 ID(`softID`)와 누적 개발자 수익 배분 금액(위안)을 반환해요. 직접 개발한 소프트웨어나 확장 프로그램을 다른 사람이 사용할 때 그 사용자의 `createTask` 요청에 이 ID를 넣으면, 사용자의 소비 금액에 따라 수익을 배분받을 수 있어요. 배분 규칙과 출금은 [개발자 수익 배분](https://docs.yescaptcha.com/ko/account/developer.md)을 참고하세요.

- POST `https://api.yescaptcha.com/getSoftID` (글로벌 엔드포인트)
- POST `https://cn.yescaptcha.com/getSoftID` (중국 엔드포인트)

## 요청 파라미터

| 필드 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `clientKey` | string | 예 | 개발자 본인의 ClientKey |

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

## 반환 결과

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

| 필드 | 타입 | 설명 |
| --- | --- | --- |
| `softID` | integer | 개발자 ID |
| `balance` | number | 누적 개발자 수익 배분 잔액이에요. 단위는 위안이에요 |

## 사용 방법

내 소프트웨어를 사용하는 사용자가 보내는 `createTask` 요청에 최상위 필드 `softID`를 추가하세요.

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

> **주의:** `softID`는 요청 본문의 최상위에 `clientKey`, `task`와 같은 위치로 넣어야 하고, 필드명의 대소문자도 정확히 맞춰야 해요. `task` 안에 넣으면 적용되지 않아요.

`clientKey`는 사용자 본인의 키이고 포인트도 사용자에게서 차감돼요. `softID`는 개발자 본인의 개발자 ID예요.