solvethree API 키 생성 및 사용하기

1. 1.

   API 키 열기

   콘솔의 사용할 워크스페이스에서 /api-keys의 API 키를 여세요.

2. 2.

   키 이름 지정하기

   API 키 생성을 선택하세요. 키 이름에 사용처를 알아볼 수 있는 이름을 입력한 뒤 키 생성을 선택하세요.

3. 3.

   전체 비밀 키 복사하기

   API 키 저장 아래에서 비밀 키를 복사하고 서버 애플리케이션에서 사용할 수 있도록 안전하게 보관하세요. 비밀 키는 한 번만 표시됩니다.

4. 4.

   대화 상자 닫기

   비밀 키를 저장한 후에만 이 키를 저장했습니다를 선택하세요.

Authorization: Bearer 뒤에 전체 워크스페이스 키를 붙여 요청을 인증하세요. 브라우저 측 코드에 키를 포함하지 마세요.

아래 예제에서는 서버 환경의 SOLVETHREE_API_KEY를 비밀 키로, SOLVETHREE_PROXY를 프록시 URL로 설정하세요. accounts.example.com과 login을 대상 호스트 이름과 액션으로 바꾸세요. 대상 사이트에는 이 워크스페이스에서 사용할 수 있는 활성 프로필이 이미 있어야 합니다. 호스트 이름을 전송해도 프로필이 생성되지는 않습니다. 아직 구성하지 않았다면 사이트 프로필 설정을 참고하세요.

# Set SOLVETHREE_API_KEY and SOLVETHREE_PROXY in your environment first.
# Replace the hostname and action with your active site profile.
jq -n \
  --arg proxy "$SOLVETHREE_PROXY" \
  --arg requestId "login-$(date +%s)-$$" \
  '{site:"accounts.example.com", action:"login", proxy:$proxy, requestId:$requestId}' \
| curl --fail-with-body --max-time 30 \
  'https://api.solvethree.com/v1/tasks?waitMs=15000' \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @-

이 요청은 공개 API에 작업 생성을 요청합니다. 단순한 인증 확인이 아니라 실제 CAPTCHA 해결 작업을 생성하므로 ready 상태의 작업에는 요금이 부과됩니다. HTTP 응답이 성공했다고 해서 작업이 준비되었거나 대상 웹사이트가 솔루션을 수락한다는 뜻은 아닙니다.

API가 HTTP 401을 반환합니다.

서버의 Authorization 헤더를 확인하세요. Bearer 뒤에는 키 이름이나 표시된 접두사가 아닌 전체 비밀 키가 와야 합니다. 키가 폐기되었는지도 확인하세요.

다음을 시도해 보세요: 헤더를 수정하거나 폐기된 키를 교체하고 서버 설정을 업데이트하세요. 작업 페이로드를 읽기 전에 성공이 아닌 HTTP 응답을 처리하세요.

키 인증은 되지만 필요한 사이트 프로필을 사용할 수 없습니다.

키가 속한 워크스페이스와 해당 워크스페이스에 대상 사이트의 활성 프로필이 있는지 확인하세요. 다른 워크스페이스의 유효한 키가 모든 워크스페이스에서 통용되는 자격 증명은 아닙니다.

다음을 시도해 보세요: 필요한 프로필이 있는 워크스페이스의 키를 사용하거나 현재 사용하는 워크스페이스에 프로필을 설정하세요. 요청에서 호스트 이름을 변경해도 프로필은 생성되지 않습니다.

그 밖의 요청 및 작업 실패는 CAPTCHA API 오류를 참고하세요.