엔드포인트

YesCaptcha API에는 엔드포인트가 두 개 있고, 메서드와 파라미터는 완전히 같아요. 서버 위치에 맞는 쪽을 고르세요.

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

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

POSThttps://api.yescaptcha.com/createTask글로벌 엔드포인트복사

POSThttps://cn.yescaptcha.com/createTask중국 엔드포인트복사

규칙

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

참고

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

전체 메서드

메서드	기능	설명
createTask	작업 생성	동기 유형은 결과를 바로 반환해요
getTaskResult	작업 결과 조회	비동기 유형은 5초마다 조회하세요
getBalance	잔액 조회	포인트가 차감되지 않아요
getSoftID	개발자 ID 조회	개발자 수익 배분에 사용해요
report	인식 결과 신고	이미지 인식 유형은 포인트 환불을 신청할 수 있어요
useragent	권장 User-Agent 가져오기	GET, hCaptcha에서 사용해요

연결이 안 될 때는 연결 및 네트워크 문제를 참고하세요.