# エンドポイント

> YesCaptcha API の2つのエンドポイント、グローバルの api.yescaptcha.com と中国の cn.yescaptcha.com。HTTPS の POST と JSON のみ対応。タスクの作成と取得は同じエンドポイントで行います。

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

YesCaptcha API には2つのエンドポイントがあり、メソッドとパラメータはまったく同じです。サーバーの所在地に合わせて選んでください。

| エンドポイント | アドレス | 適した用途 |
| --- | --- | --- |
| グローバルエンドポイント | `https://api.yescaptcha.com` | 中国本土以外のサーバー |
| 中国エンドポイント | `https://cn.yescaptcha.com` | 中国本土のサーバー |

メソッドの URL はエンドポイントにメソッド名を付けたものです。例としてタスクの作成は次のとおりです。

- POST `https://api.yescaptcha.com/createTask` (グローバルエンドポイント)
- POST `https://cn.yescaptcha.com/createTask` (中国エンドポイント)

## ルール

-   HTTPS のみ使用できます。
-   [/useragent](https://docs.yescaptcha.com/ja/api/useragent.md) 以外のすべてのメソッドは `POST` を使い、リクエストボディは JSON で、ヘッダー `Content-Type: application/json` を付けます。ボディは 6 MB 以内にしてください。
-   認証はボディ内の `clientKey` で行います。ほかのヘッダーは不要です。

> **ノート:** タスクを作成したエンドポイントと同じエンドポイントで `getTaskResult` を使って取得してください。2つのエンドポイントを混在させないでください。

## すべてのメソッド

| メソッド | 役割 | 説明 |
| --- | --- | --- |
| [createTask](https://docs.yescaptcha.com/ja/api/create-task.md) | タスクを作成 | 同期タイプは結果をそのまま返します |
| [getTaskResult](https://docs.yescaptcha.com/ja/api/get-task-result.md) | タスクの結果を取得 | 非同期タイプは 5 秒ごとにポーリングします |
| [getBalance](https://docs.yescaptcha.com/ja/api/get-balance.md) | 残高を取得 | 課金されません |
| [getSoftID](https://docs.yescaptcha.com/ja/api/get-soft-id.md) | 開発者 ID を取得 | 開発者収益分配に使います |
| [report](https://docs.yescaptcha.com/ja/api/report.md) | 認識結果を報告 | 画像認識タイプは報告による返金を申請できます |
| [useragent](https://docs.yescaptcha.com/ja/api/useragent.md) | 推奨の User-Agent を取得 | `GET`、hCaptcha で使います |

接続できない場合は、[接続とネットワークの問題](https://docs.yescaptcha.com/ja/help/troubleshooting.md)を参照してください。