# Endpoints

> Les deux endpoints de l'API YesCaptcha, l'endpoint mondial api.yescaptcha.com et l'endpoint Chine cn.yescaptcha.com. HTTPS POST avec JSON uniquement ; créez et interrogez une tâche sur le même endpoint.

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

L’API YesCaptcha propose deux endpoints dont les méthodes et les paramètres sont identiques. Choisissez celui qui correspond à l’emplacement de vos serveurs :

| Endpoint | Adresse | À utiliser pour |
| --- | --- | --- |
| Endpoint mondial | `https://api.yescaptcha.com` | Serveurs hors de Chine continentale |
| Endpoint Chine | `https://cn.yescaptcha.com` | Serveurs en Chine continentale |

L’URL d’une méthode est l’adresse de l’endpoint suivie du nom de la méthode, par exemple pour créer une tâche :

- POST `https://api.yescaptcha.com/createTask` (Endpoint mondial)
- POST `https://cn.yescaptcha.com/createTask` (Endpoint Chine)

## Règles

-   HTTPS uniquement.
-   Toutes les méthodes, sauf [/useragent](https://docs.yescaptcha.com/fr/api/useragent.md), utilisent `POST` avec un corps JSON et l’en-tête `Content-Type: application/json`. Le corps de la requête ne doit pas dépasser 6 MB.
-   L’authentification se fait avec le `clientKey` dans le corps de la requête ; aucun autre en-tête n’est nécessaire.

> **Note:** Interrogez une tâche avec `getTaskResult` sur le même endpoint que celui où vous l’avez créée. Ne mélangez pas les deux endpoints.

## Toutes les méthodes

| Méthode | Rôle | Remarques |
| --- | --- | --- |
| [createTask](https://docs.yescaptcha.com/fr/api/create-task.md) | Créer une tâche | Les types synchrones renvoient directement le résultat |
| [getTaskResult](https://docs.yescaptcha.com/fr/api/get-task-result.md) | Obtenir le résultat d’une tâche | Pour les types asynchrones, interrogez toutes les 5 secondes |
| [getBalance](https://docs.yescaptcha.com/fr/api/get-balance.md) | Consulter le solde | Sans débit de points |
| [getSoftID](https://docs.yescaptcha.com/fr/api/get-soft-id.md) | Obtenir votre ID développeur | Pour la part développeur |
| [report](https://docs.yescaptcha.com/fr/api/report.md) | Signaler un résultat | Les types de reconnaissance d’images peuvent donner lieu à un remboursement après signalement |
| [useragent](https://docs.yescaptcha.com/fr/api/useragent.md) | Obtenir le User-Agent recommandé | `GET`, utilisé avec hCaptcha |

Si vous n’arrivez pas à vous connecter, consultez [Problèmes de connexion et de réseau](https://docs.yescaptcha.com/fr/help/troubleshooting.md).