# Endpoints

> Die zwei Endpoints der YesCaptcha API, der globale api.yescaptcha.com und der China-Endpoint cn.yescaptcha.com. Nur HTTPS POST mit JSON; Aufgaben werden auf demselben Endpoint erstellt und abgefragt.

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

Die YesCaptcha API hat zwei Endpoints mit identischen Methoden und Parametern. Wählen Sie den Endpoint, der zum Standort Ihrer Server passt:

| Endpoint | Adresse | Geeignet für |
| --- | --- | --- |
| Globaler Endpoint | `https://api.yescaptcha.com` | Server außerhalb des chinesischen Festlands |
| China-Endpoint | `https://cn.yescaptcha.com` | Server auf dem chinesischen Festland |

Die URL einer Methode besteht aus der Endpoint-Adresse und dem Methodennamen, zum Beispiel beim Erstellen einer Aufgabe:

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

## Regeln

-   Verwenden Sie nur HTTPS.
-   Alle Methoden außer [/useragent](https://docs.yescaptcha.com/de/api/useragent.md) verwenden `POST` mit einem JSON-Body und dem Header `Content-Type: application/json`. Der Body darf höchstens 6 MB groß sein.
-   Die Authentifizierung erfolgt über den `clientKey` im Body; weitere Header sind nicht nötig.

> **Hinweis:** Fragen Sie eine Aufgabe mit `getTaskResult` auf demselben Endpoint ab, auf dem Sie sie erstellt haben. Verwenden Sie die beiden Endpoints nicht gemischt.

## Alle Methoden

| Methode | Zweck | Hinweise |
| --- | --- | --- |
| [createTask](https://docs.yescaptcha.com/de/api/create-task.md) | Aufgabe erstellen | Synchrone Typen geben das Ergebnis direkt zurück |
| [getTaskResult](https://docs.yescaptcha.com/de/api/get-task-result.md) | Aufgabenergebnis abfragen | Bei asynchronen Typen alle 5 Sekunden abfragen |
| [getBalance](https://docs.yescaptcha.com/de/api/get-balance.md) | Guthaben abfragen | Kein Punkteabzug |
| [getSoftID](https://docs.yescaptcha.com/de/api/get-soft-id.md) | Entwickler-ID abfragen | Für die Entwicklerbeteiligung |
| [report](https://docs.yescaptcha.com/de/api/report.md) | Ergebnisse melden | Bei Typen der Bilderkennung kann eine Erstattung nach Meldung beantragt werden |
| [useragent](https://docs.yescaptcha.com/de/api/useragent.md) | Empfohlenen User-Agent abrufen | `GET`, für hCaptcha |

Wenn Sie keine Verbindung herstellen können, lesen Sie [Verbindungs- und Netzwerkprobleme](https://docs.yescaptcha.com/de/help/troubleshooting.md).