# 엔드포인트

> YesCaptcha API의 두 엔드포인트인 글로벌 엔드포인트 api.yescaptcha.com과 중국 엔드포인트 cn.yescaptcha.com이에요. HTTPS POST JSON만 받으며, 작업 생성과 조회는 같은 엔드포인트에서 해야 해요.

Source: https://docs.yescaptcha.com/ko/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에는 엔드포인트가 두 개 있고, 메서드와 파라미터는 완전히 같아요. 서버 위치에 맞는 쪽을 고르세요.

| 엔드포인트 | 주소 | 적합한 경우 |
| --- | --- | --- |
| 글로벌 엔드포인트 | `https://api.yescaptcha.com` | 중국 본토 밖의 서버 |
| 중국 엔드포인트 | `https://cn.yescaptcha.com` | 중국 본토의 서버 |

메서드 URL은 엔드포인트 주소 + 메서드 이름이에요. 예를 들어 작업을 생성하는 URL은 다음과 같아요.

- POST `https://api.yescaptcha.com/createTask` (글로벌 엔드포인트)
- POST `https://cn.yescaptcha.com/createTask` (중국 엔드포인트)

## 규칙

-   HTTPS만 사용하세요.
-   [/useragent](https://docs.yescaptcha.com/ko/api/useragent.md)를 제외한 모든 메서드는 `POST`를 사용하고, 요청 본문은 JSON이며 요청 헤더 `Content-Type: application/json`을 포함해야 해요. 요청 본문은 6 MB를 넘을 수 없어요.
-   요청 본문의 `clientKey`로 인증하며, 다른 요청 헤더는 필요 없어요.

> **참고:** 작업을 생성한 엔드포인트에서 `getTaskResult`로 조회하세요. 두 엔드포인트를 섞어 쓰면 안 돼요.

## 전체 메서드

| 메서드 | 기능 | 설명 |
| --- | --- | --- |
| [createTask](https://docs.yescaptcha.com/ko/api/create-task.md) | 작업 생성 | 동기 유형은 결과를 바로 반환해요 |
| [getTaskResult](https://docs.yescaptcha.com/ko/api/get-task-result.md) | 작업 결과 조회 | 비동기 유형은 5초마다 조회하세요 |
| [getBalance](https://docs.yescaptcha.com/ko/api/get-balance.md) | 잔액 조회 | 포인트가 차감되지 않아요 |
| [getSoftID](https://docs.yescaptcha.com/ko/api/get-soft-id.md) | 개발자 ID 조회 | 개발자 수익 배분에 사용해요 |
| [report](https://docs.yescaptcha.com/ko/api/report.md) | 인식 결과 신고 | 이미지 인식 유형은 포인트 환불을 신청할 수 있어요 |
| [useragent](https://docs.yescaptcha.com/ko/api/useragent.md) | 권장 User-Agent 가져오기 | `GET`, hCaptcha에서 사용해요 |

연결이 안 될 때는 [연결 및 네트워크 문제](https://docs.yescaptcha.com/ko/help/troubleshooting.md)를 참고하세요.