# Endpoints

> Os dois endpoints da API do YesCaptcha: global api.yescaptcha.com e China cn.yescaptcha.com. Aceita apenas HTTPS POST com JSON; crie e consulte a tarefa no mesmo endpoint.

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

A API do YesCaptcha tem dois endpoints, com métodos e parâmetros idênticos. Escolha conforme a localização do seu servidor:

| Endpoint | Endereço | Indicado para |
| --- | --- | --- |
| Endpoint global | `https://api.yescaptcha.com` | Servidores fora da China continental |
| Endpoint China | `https://cn.yescaptcha.com` | Servidores na China continental |

A URL de um método é o endereço do endpoint mais o nome do método, por exemplo, para criar uma tarefa:

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

## Regras

-   Use apenas HTTPS.
-   Todos os métodos, exceto [/useragent](https://docs.yescaptcha.com/pt/api/useragent.md), usam `POST` com corpo JSON e o cabeçalho `Content-Type: application/json`. O corpo da requisição não pode ultrapassar 6 MB.
-   A autenticação é feita pela `clientKey` no corpo da requisição; nenhum outro cabeçalho é necessário.

> **Nota:** Consulte a tarefa com `getTaskResult` no mesmo endpoint em que a criou. Não misture os dois endpoints.

## Todos os métodos

| Método | Função | Observações |
| --- | --- | --- |
| [createTask](https://docs.yescaptcha.com/pt/api/create-task.md) | Criar uma tarefa | Tipos síncronos retornam o resultado diretamente |
| [getTaskResult](https://docs.yescaptcha.com/pt/api/get-task-result.md) | Consultar o resultado da tarefa | Nos tipos assíncronos, consulte a cada 5 segundos |
| [getBalance](https://docs.yescaptcha.com/pt/api/get-balance.md) | Consultar o saldo | Sem cobrança de pontos |
| [getSoftID](https://docs.yescaptcha.com/pt/api/get-soft-id.md) | Consultar o ID de desenvolvedor | Usado na participação do desenvolvedor |
| [report](https://docs.yescaptcha.com/pt/api/report.md) | Reportar o resultado do reconhecimento | Tipos de reconhecimento de imagem podem solicitar reembolso de pontos após reportar |
| [useragent](https://docs.yescaptcha.com/pt/api/useragent.md) | Obter o User-Agent recomendado | `GET`, usado com hCaptcha |

Se não conseguir se conectar à API, consulte [Problemas de conexão e rede](https://docs.yescaptcha.com/pt/help/troubleshooting.md).