Postman에서 solvethree 테스트하기

1. 1.

   다운로드한 JSON 가져오기

   Postman에서 가져오기를 선택하고 컬렉션 파일을 선택하세요. 이 컬렉션에는 Bearer 인증을 상속하고 변수 자리표시자를 사용하는 작업 생성 및 작업 조회 요청이 포함되어 있습니다.

2. 2.

   사이트 프로필 확인하기

   워크스페이스에는 대상 호스트 이름에 대한 활성 프로필이 필요합니다. 테스트 전에 콘솔에서 설정하세요. 호스트 이름과 액션을 보내는 것만으로는 프로필이 생성되지 않습니다. 사이트 프로필 설정을 참고하세요.

3. 3.

   비공개 환경 값 설정하기

   이 테스트에 사용할 환경을 생성하고 선택하세요. 프록시 자격 증명을 포함하여 아래 값을 비공개로 입력하세요. 비밀 정보를 컬렉션에 직접 넣거나 비밀 정보가 입력된 상태로 내보내지 마세요.

4. 4.

   Bearer 인증 설정하기

   컬렉션 수준에서 Bearer Token을 선택하고 워크스페이스 API 키가 포함된 비공개 환경 변수를 참조하세요. 두 요청 모두 인증을 상속하도록 유지하세요. API는 Authorization: Bearer 뒤에 해당 키가 오는 형식을 요구합니다.

작업 생성 요청을 여세요. 선택한 환경의 값으로 채워진 원시 JSON 본문을 사용하여 https://api.solvethree.com/v1/tasks로 POST 요청을 보냅니다.

{
  "site": "{{SITE}}",
  "action": "{{ACTION}}",
  "proxy": "{{PROXY}}",
  "requestId": "{{REQUEST_ID}}"
}

이 요청은 기본적으로 reCAPTCHA Enterprise v3를 사용합니다. type이나 url 필드를 추가하지 마세요. 단일 proxy를 제공하므로 proxyCandidates를 함께 추가하지 마세요. 이 두 필드 중 정확히 하나가 필요합니다.

보내기 전에 REQUEST_ID를 설정한 다음 보내기를 한 번 클릭하세요. 먼저 HTTP 응답을 확인하세요. 성공 응답이 아니라면 본문을 성공한 작업 응답으로 취급하지 말고 요청 오류를 확인하세요. 잘못된 입력은 그대로 반복해서 보내지 말고 수정하세요.

생성 응답이 성공하면 반환된 id를 비공개 환경 값 TASK_ID에 복사하세요. 진행 상황을 확인하려고 작업 생성을 다시 클릭하지 마세요.

작업 조회 요청을 열고 TASK_ID에 반환된 작업 ID가 들어 있는지 확인하세요. 이 요청은 동일한 API에서 GET /v1/tasks/:id를 사용합니다. 수동으로 보낸 후 HTTP 응답을 확인하고 작업의 status를 살펴보세요.

HTTP 200 또는 201만으로는 솔루션이 준비되었다고 볼 수 없습니다. status: ready일 때만 준비된 것입니다. 이 수동 테스트는 작업 생성과 조회를 확인하며, 대상 웹사이트가 결과를 수락하는지는 확인하지 않습니다.

이어서 reCAPTCHA 토큰을 지정된 대상에 제출한다면 반환된 userAgent 및 secChUa 브라우저 식별 정보와 성공한 프록시를 사용하세요. IP를 바꾸거나 관련 없는 브라우저 식별 정보를 섞어 쓰지 마세요. 준비된 토큰도 대상에서 거부될 수 있습니다.

연결 타임아웃이 발생했다고 해서 생성이 실패한 것은 아닙니다. 작업 ID가 있다면 해당 작업을 조회하세요. ID를 받지 못했다면 동일한 REQUEST_ID와 변경하지 않은 작업 입력으로 작업 생성 요청을 다시 보내세요. 그러면 논리적으로 새로운 작업을 생성하는 대신 기존 작업을 복구합니다.

응답을 받지 못했다는 이유만으로 새 REQUEST_ID를 생성하지 마세요. 다른 작업 입력으로 ID를 재사용하면 충돌이 발생합니다. 의도적으로 새 작업을 시작할 때 새 ID를 사용하세요.