ДЛЯ СТРОИТЕЛЕЙ

Ваш код.
Новый рабочий процесс.

Откройте для себя предлагаемую интеграцию и подготовьте свое приложение для 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

Проверьте возвращенный код ошибки и описание.

Обрабатывайте неверные учетные данные, недостаточный баланс, неожиданные ответы и тайм-ауты. Окончательные имена ошибок будут определены API.

Нужна помощь в интеграции?