# getSoftID ค้นหา ID นักพัฒนา

> POST /getSoftID ใช้ค้นหา ID นักพัฒนา (softID) และยอดส่วนแบ่งรายได้สะสมของคุณ ใส่ softID ในคำขอ createTask ที่ซอฟต์แวร์ของคุณส่งแทนผู้ใช้คนอื่น เพื่อรับส่วนแบ่ง

Source: https://docs.yescaptcha.com/th/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`) และยอดส่วนแบ่งรายได้นักพัฒนาสะสม (หน่วยเป็นหยวน) ของคุณ เมื่อมีผู้อื่นใช้ซอฟต์แวร์หรือส่วนขยายที่คุณพัฒนา ให้ใส่ ID นี้ในคำขอ `createTask` ของผู้ใช้เหล่านั้น คุณจะได้รับส่วนแบ่งตามยอดที่พวกเขาใช้จ่าย กติกาส่วนแบ่งและการถอนเงินดูได้ที่ [ส่วนแบ่งรายได้นักพัฒนา](https://docs.yescaptcha.com/th/account/developer.md)

- POST `https://api.yescaptcha.com/getSoftID` (endpoint ทั่วโลก)
- POST `https://cn.yescaptcha.com/getSoftID` (endpoint จีน)

## พารามิเตอร์ของคำขอ

| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
| --- | --- | --- | --- |
| `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` ต้องอยู่ระดับบนสุดของ request body ในระดับเดียวกับ `clientKey` และ `task` โดยตัวพิมพ์เล็กพิมพ์ใหญ่ของชื่อฟิลด์ต้องตรงกัน หากใส่ไว้ใน `task` จะไม่มีผล

`clientKey` คือ ClientKey ของผู้ใช้เอง และระบบจะหักพอยต์จากผู้ใช้ ส่วน `softID` คือ ID นักพัฒนาของคุณ