# Endpoint

> Dua endpoint YesCaptcha API, global api.yescaptcha.com dan Tiongkok cn.yescaptcha.com. Hanya menerima HTTPS POST dengan JSON; buat dan periksa tugas di endpoint yang sama.

Source: https://docs.yescaptcha.com/id/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 memiliki dua endpoint dengan antarmuka dan parameter yang sama persis. Pilih sesuai lokasi server Anda:

| Endpoint | Alamat | Cocok untuk |
| --- | --- | --- |
| Endpoint global | `https://api.yescaptcha.com` | Server di luar Tiongkok daratan |
| Endpoint Tiongkok | `https://cn.yescaptcha.com` | Server di Tiongkok daratan |

URL metode = alamat endpoint + nama metode, misalnya untuk membuat tugas:

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

## Aturan

-   Hanya gunakan HTTPS.
-   Semua metode kecuali [/useragent](https://docs.yescaptcha.com/id/api/useragent.md) menggunakan `POST`, dengan body berupa JSON dan header `Content-Type: application/json`. Ukuran body tidak boleh melebihi 6 MB.
-   Autentikasi menggunakan `clientKey` di body request; tidak perlu header lain.

> **Catatan:** Periksa tugas dengan `getTaskResult` di endpoint yang sama tempat Anda membuatnya. Jangan campur kedua endpoint.

## Semua metode

| Metode | Fungsi | Keterangan |
| --- | --- | --- |
| [createTask](https://docs.yescaptcha.com/id/api/create-task.md) | Membuat tugas | Jenis sinkron langsung mengembalikan hasil |
| [getTaskResult](https://docs.yescaptcha.com/id/api/get-task-result.md) | Memeriksa hasil tugas | Untuk jenis asinkron, lakukan polling setiap 5 detik |
| [getBalance](https://docs.yescaptcha.com/id/api/get-balance.md) | Memeriksa saldo | Tanpa pemotongan poin |
| [getSoftID](https://docs.yescaptcha.com/id/api/get-soft-id.md) | Memeriksa ID developer | Untuk bagi hasil developer |
| [report](https://docs.yescaptcha.com/id/api/report.md) | Melaporkan hasil pengenalan | Jenis pengenalan gambar dapat mengajukan pengembalian poin setelah laporan |
| [useragent](https://docs.yescaptcha.com/id/api/useragent.md) | Mendapatkan User-Agent yang disarankan | `GET`, digunakan untuk hCaptcha |

Jika tidak dapat terhubung ke API, lihat [Masalah koneksi dan jaringan](https://docs.yescaptcha.com/id/help/troubleshooting.md).