# Адреса доступа

> Два endpoint API YesCaptcha — глобальный api.yescaptcha.com и для Китая cn.yescaptcha.com. Только HTTPS POST с JSON; создавайте и запрашивайте задачу на одном и том же endpoint.

Source: https://docs.yescaptcha.com/ru/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/

У API YesCaptcha два endpoint с одинаковыми методами и параметрами. Выберите тот, что ближе к вашим серверам:

| Endpoint | Адрес | Для чего |
| --- | --- | --- |
| Глобальный | `https://api.yescaptcha.com` | Серверы за пределами материкового Китая |
| Для Китая | `https://cn.yescaptcha.com` | Серверы в материковом Китае |

URL метода — это адрес endpoint плюс имя метода, например для создания задачи:

- POST `https://api.yescaptcha.com/createTask` (Глобальный endpoint)
- POST `https://cn.yescaptcha.com/createTask` (Endpoint для Китая)

## Правила

-   Только HTTPS.
-   Все методы, кроме [/useragent](https://docs.yescaptcha.com/ru/api/useragent.md), используют `POST` с телом в формате JSON и заголовком `Content-Type: application/json`. Размер тела не должен превышать 6 MB.
-   Аутентификация выполняется по `clientKey` в теле запроса; другие заголовки не нужны.

> **Заметка:** Запрашивайте результат задачи через `getTaskResult` на том же endpoint, на котором вы её создали. Не смешивайте два endpoint.

## Все методы

| Метод | Назначение | Примечания |
| --- | --- | --- |
| [createTask](https://docs.yescaptcha.com/ru/api/create-task.md) | Создать задачу | Синхронные типы сразу возвращают результат |
| [getTaskResult](https://docs.yescaptcha.com/ru/api/get-task-result.md) | Получить результат задачи | Для асинхронных типов опрашивайте (polling) каждые 5 секунд |
| [getBalance](https://docs.yescaptcha.com/ru/api/get-balance.md) | Узнать баланс | Баллы не списываются |
| [getSoftID](https://docs.yescaptcha.com/ru/api/get-soft-id.md) | Узнать ID разработчика | Для доли разработчика |
| [report](https://docs.yescaptcha.com/ru/api/report.md) | Сообщить о неверном результате | Для типов распознавания изображений возможен возврат баллов после жалобы |
| [useragent](https://docs.yescaptcha.com/ru/api/useragent.md) | Получить рекомендуемый User-Agent | `GET`, используется с hCaptcha |

Если не удаётся подключиться, см. [Проблемы с подключением и сетью](https://docs.yescaptcha.com/ru/help/troubleshooting.md).