# Endpoints

> Los dos endpoints de la API de YesCaptcha: el global api.yescaptcha.com y el de China cn.yescaptcha.com. Solo HTTPS POST con JSON; crea y consulta una tarea en el mismo endpoint.

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

La API de YesCaptcha tiene dos endpoints con los mismos métodos y parámetros. Elige el más cercano a tus servidores:

| Endpoint | Dirección | Úsalo para |
| --- | --- | --- |
| Global | `https://api.yescaptcha.com` | Servidores fuera de China continental |
| China | `https://cn.yescaptcha.com` | Servidores en China continental |

La URL de un método es el endpoint más el nombre del método, por ejemplo para crear una tarea:

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

## Reglas

-   Usa solo HTTPS.
-   Todos los métodos excepto [/useragent](https://docs.yescaptcha.com/es/api/useragent.md) usan `POST` con un cuerpo JSON y el encabezado `Content-Type: application/json`. El cuerpo no puede superar los 6 MB.
-   La autenticación se hace con el `clientKey` del cuerpo; no se necesitan otros encabezados.

> **Nota:** Consulta una tarea con `getTaskResult` en el mismo endpoint en el que la creaste. No mezcles los dos endpoints.

## Todos los métodos

| Método | Función | Notas |
| --- | --- | --- |
| [createTask](https://docs.yescaptcha.com/es/api/create-task.md) | Crear una tarea | Los tipos síncronos devuelven el resultado directamente |
| [getTaskResult](https://docs.yescaptcha.com/es/api/get-task-result.md) | Obtener el resultado de la tarea | En los tipos asíncronos, consulta cada 5 segundos |
| [getBalance](https://docs.yescaptcha.com/es/api/get-balance.md) | Consultar el saldo | No cobra puntos |
| [getSoftID](https://docs.yescaptcha.com/es/api/get-soft-id.md) | Consultar tu ID de desarrollador | Para la participación del desarrollador |
| [report](https://docs.yescaptcha.com/es/api/report.md) | Reportar resultados | En los tipos de reconocimiento de imágenes se puede solicitar un reembolso tras reportar |
| [useragent](https://docs.yescaptcha.com/es/api/useragent.md) | Obtener el User-Agent recomendado | `GET`, se usa con hCaptcha |

Si no puedes conectarte, consulta [Problemas de conexión y red](https://docs.yescaptcha.com/es/help/troubleshooting.md).