Insomnia에서 CAPTCHA API 테스트하기

워크스페이스 API 키, 대상 사이트의 활성 프로필, 프록시가 필요합니다. 작업을 전송하기 전에 사이트 프로필을 설정하세요. 호스트 이름과 액션을 제공하는 것만으로는 프로필이 생성되지 않습니다.

아래 변수를 사용해 solvethree-local이라는 비공개 로컬 환경을 만드세요. 이 이름들은 이 가이드에서 정한 것으로, 추가 API 필드가 아닙니다. API 키와 프록시 인증 정보가 공유 설정에 포함되지 않도록 하세요.

1. 1.

   생성 요청 구성

   api_base 뒤에 /tasks를 붙여 POST 요청을 만드세요. 쿼리 매개변수 waitMs를 추가하고 값을 0으로 설정하세요. Bearer 인증을 선택하고 토큰으로 api_key를 제공하세요. 요청은 Bearer 스킴을 사용하는 Authorization 헤더를 전송해야 합니다.

2. 2.

   JSON 본문 구성

   site, action, proxy, requestId가 포함된 JSON 본문을 선택하세요. 처음 세 필드는 각각에 해당하는 로컬 변수로 채우고, requestId는 request_id로 채우세요. proxy와 proxyCandidates 중 정확히 하나만 전송하세요. 이 가이드에서는 proxy를 사용합니다. type이나 url은 추가하지 마세요. recaptchaType을 생략하면 기본값인 enterprise-v3가 선택됩니다.

3. 3.

   전송 후 응답 확인

   응답을 성공한 작업의 페이로드로 읽기 전에 HTTP 응답을 확인하세요. 생성에 성공하면 반환된 작업 ID를 task_id에 복사하세요. 요청을 복구해야 할 경우에 대비해 작업 본문과 request_id를 보관하세요.

4. 4.

   해당 작업 조회

   api_base 뒤에 /tasks/와 복사한 작업 ID를 붙여 GET 요청을 만드세요. waitMs를 15000으로 설정하고, 동일한 Bearer 키를 사용하며, 본문은 비워 두세요. ID는 직접 복사하세요. 이 가이드는 응답 체이닝 표현식에 의존하지 않습니다.

Create task
  Method: POST
  URL: https://api.solvethree.com/v1/tasks?waitMs=0
  Auth: Bearer Token — your private workspace key
  Body: JSON — site, action, proxy and a stable requestId

Retrieve task
  Method: GET
  URL: https://api.solvethree.com/v1/tasks/PASTE_RETURNED_ID?waitMs=15000
  Auth: Bearer Token — the same workspace key
  Body: none

Keep the task's proxy in the JSON body. Insomnia's own network proxy setting
controls its API connection, not the proxy used to generate/submit the solution.

HTTP 요청이 성공이 아닌 응답을 반환합니다.

성공한 작업의 페이로드를 읽으려 하기 전에 HTTP 오류를 확인하세요.

다음을 시도해 보세요: 보고된 요청 또는 인증 문제를 수정하세요. 잘못된 입력을 변경하지 않은 채 반복해서 제출하거나, 모든 오류가 크레딧 부족을 의미한다고 가정하지 마세요.

작업 상태가 pending 또는 solving입니다.

두 상태 모두 사용 가능한 솔루션을 포함하지 않습니다.

다음을 시도해 보세요: 동일한 작업 ID로 GET 요청을 다시 보내세요. 이 작업이 아직 끝나지 않았다는 이유만으로 다른 작업을 생성하지 마세요.

작업 상태가 failed입니다.

errorCode와 error를 확인하세요. site-unreachable은 발생할 수 있는 작업 오류 중 하나입니다.

다음을 시도해 보세요: 해당 작업의 조회를 중단하고, 다른 작업을 시작하기 전에 보고된 원인을 해결하세요. 해결에 실패한 작업은 환불됩니다.

생성 요청이 ID를 반환하지 않은 채 시간 초과됩니다.

연결 시간 초과가 발생했다고 해서 생성이 실패한 것은 아닙니다.

다음을 시도해 보세요: 기존 작업을 복구하려면 동일한 requestId로 동일한 작업 본문을 다시 제출하세요. 해당 ID를 재사용하면서 입력을 변경하면 충돌이 발생합니다.

ready 상태의 reCAPTCHA 작업은 토큰을 제공합니다. 토큰을 대상에 제출할 때는 해결에 사용한 것과 동일한 프록시와 함께 반환된 userAgent 및 secChUa를 사용하세요. 준비 완료 응답은 솔루션이 생성되었음을 확인할 뿐, 애플리케이션 요청이 성공했음을 의미하지는 않습니다.