# ที่อยู่สำหรับเชื่อมต่อ

> endpoint ของ YesCaptcha API มี 2 แห่ง ได้แก่ endpoint ทั่วโลก api.yescaptcha.com และ endpoint จีน cn.yescaptcha.com รับเฉพาะ HTTPS POST แบบ JSON และต้องสร้างงานกับตรวจสอบงานที่ endpoint เดียวกัน

Source: https://docs.yescaptcha.com/th/getting-started/endpoints/ · 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/getting-started/endpoints/

YesCaptcha API มี endpoint 2 แห่ง ซึ่งมีเมธอดและพารามิเตอร์เหมือนกันทุกประการ ให้เลือกตามที่ตั้งของเซิร์ฟเวอร์ของคุณ:

| Endpoint | ที่อยู่ | เหมาะสำหรับ |
| --- | --- | --- |
| endpoint ทั่วโลก | `https://api.yescaptcha.com` | เซิร์ฟเวอร์นอกจีนแผ่นดินใหญ่ |
| endpoint จีน | `https://cn.yescaptcha.com` | เซิร์ฟเวอร์ในจีนแผ่นดินใหญ่ |

URL ของเมธอด = ที่อยู่ endpoint + ชื่อเมธอด เช่น การสร้างงาน:

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

## กฎการใช้งาน

-   ใช้ HTTPS เท่านั้น
-   ทุกเมธอดใช้ `POST` โดยส่ง body เป็น JSON และใส่ header `Content-Type: application/json` ยกเว้น [/useragent](https://docs.yescaptcha.com/th/api/useragent.md) โดย body ต้องมีขนาดไม่เกิน 6 MB
-   ยืนยันตัวตนด้วย `clientKey` ใน body ไม่ต้องใช้ header อื่น

> **หมายเหตุ:** สร้างงานที่ endpoint ใด ให้ใช้ `getTaskResult` ตรวจสอบงานที่ endpoint นั้น อย่าใช้สอง endpoint ปนกัน

## เมธอดทั้งหมด

| เมธอด | หน้าที่ | หมายเหตุ |
| --- | --- | --- |
| [createTask](https://docs.yescaptcha.com/th/api/create-task.md) | สร้างงาน | ประเภทงานแบบซิงโครนัสจะคืนผลลัพธ์ทันที |
| [getTaskResult](https://docs.yescaptcha.com/th/api/get-task-result.md) | ตรวจสอบผลลัพธ์ของงาน | ประเภทงานแบบอะซิงโครนัสให้ polling (เรียกตรวจซ้ำเป็นระยะ) ทุก 5 วินาที |
| [getBalance](https://docs.yescaptcha.com/th/api/get-balance.md) | ตรวจสอบยอดคงเหลือ | ไม่หักพอยต์ |
| [getSoftID](https://docs.yescaptcha.com/th/api/get-soft-id.md) | ตรวจสอบ ID นักพัฒนา | ใช้สำหรับส่วนแบ่งรายได้นักพัฒนา |
| [report](https://docs.yescaptcha.com/th/api/report.md) | รายงานผลการจดจำ | ประเภทงานการจดจำภาพขอคืนพอยต์หลังรายงานได้ |
| [useragent](https://docs.yescaptcha.com/th/api/useragent.md) | รับ User-Agent ที่แนะนำ | `GET` ใช้กับ hCaptcha |

หากเชื่อมต่อกับ API ไม่ได้ ดู [ปัญหาการเชื่อมต่อและเครือข่าย](https://docs.yescaptcha.com/th/help/troubleshooting.md)