빌더를 위한

귀하의 코드.
새로운 워크플로우.

제안된 통합을 살펴보고 API용 애플리케이션을 준비하세요.

제안된 계약. 실제로 사용하기 전에 엔드포인트, 매개변수 및 응답을 API 팀에서 확인해야 합니다.

시작하기

통합에는 세 가지 단계가 있습니다. 애플리케이션을 식별하고, 작업을 생성하고, 그 결과를 따르세요. 데모 대시보드에서 경험을 살펴보세요.

1실제 서비스에서 자격 증명 얻기
2유형과 매개변수를 사용하여 작업 만들기
3식별자를 사용하여 결과를 검색합니다.

인증

제안서에서 사용자 인증 정보를 사용합니다. clientKey 서버 호출에서. 공개 코드와 브라우저 외부의 환경 변수에 키를 보관하세요. 데모 대시보드 키는 서비스에 액세스할 수 없습니다.

작업 만들기

POST /createTask

선택한 유형에 대한 자격 증명과 필수 매개변수를 보냅니다.

// Contrato proposto — configure a URL da API real no servidor
const response = await fetch(API_BASE_URL + "/createTask", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    clientKey: process.env.SOLUCAPTCHA_API_KEY,
    task: {
      type: "RecaptchaV2Task",
      websiteURL: "https://sua-aplicacao.com",
      websiteKey: "SUA_SITE_KEY"
    }
  })
});
if (!response.ok) throw new Error("Falha ao criar tarefa");
const task = await response.json();

예상되는 반응

{
  "errorId": 0,
  "taskId": "example-task-id"
}

결과 검색

POST /getTaskResult

사용 taskId 상태를 확인하기 위해. 처리 중인 경우 API 정의 간격 및 제한을 준수하여 다시 확인하기 전에 기다리십시오.

{
  "clientKey": "SUA_CHAVE_NO_SERVIDOR",
  "taskId": "example-task-id"
}

상태 및 오류

ready

작업에 사용 가능한 결과가 있습니다.

processing

작업이 아직 처리 중입니다.

error

반환된 오류 코드와 설명을 확인하세요.

Handle invalid credentials, insufficient balance, unexpected responses and timeouts. 최종 오류 이름은 API에 의해 정의됩니다.

통합하는 데 도움이 필요하십니까?