Crie e use sua chave de API da solvethree

1. 1.

   Abra Chaves de API

   No console, abra Chaves de API em /api-keys no espaço de trabalho desejado.

2. 2.

   Dê um nome à chave

   Selecione Criar chave de API. Em Nome da chave, insira um nome que ajude a reconhecer onde você a usará e selecione Criar chave.

3. 3.

   Copie o segredo completo

   Em Salve sua chave de API, copie o segredo e armazene-o com segurança para sua aplicação de servidor. Ele é exibido apenas uma vez.

4. 4.

   Feche a caixa de diálogo

   Selecione Salvei esta chave somente depois de armazenar o segredo.

Autentique as requisições com Authorization: Bearer seguido da chave completa do espaço de trabalho. Mantenha-a fora do código executado no navegador.

Para o exemplo abaixo, defina SOLVETHREE_API_KEY com seu segredo e SOLVETHREE_PROXY com a URL do seu proxy no ambiente do servidor. Substitua accounts.example.com e login pelo hostname e pela ação do destino. O site de destino já deve ter um perfil ativo disponível para esse espaço de trabalho; enviar o hostname não cria um perfil. Consulte a configuração de perfil de site se ainda não o configurou.

# 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 @-

Isso envia uma requisição de criação de tarefa à API pública. Ela cria uma resolução real, não apenas uma verificação de autenticação: uma tarefa pronta é cobrada. Uma resposta HTTP bem-sucedida, por si só, não significa que a tarefa está pronta nem que o site de destino aceitará a solução.

A API retorna HTTP 401.

Verifique o cabeçalho Authorization do servidor. Ele precisa conter Bearer seguido do segredo completo, não do nome da chave ou de um prefixo revelado. Verifique se a chave foi revogada.

Experimente: Corrija o cabeçalho ou substitua a chave revogada e atualize a configuração do servidor. Trate a resposta HTTP sem sucesso antes de tentar ler o payload de uma tarefa.

A chave autentica, mas o perfil de site desejado não está disponível.

Confirme a qual espaço de trabalho a chave pertence e se esse espaço tem um perfil ativo para o site de destino. Uma chave válida de outro espaço de trabalho não é uma credencial global.

Experimente: Use uma chave pertencente ao espaço de trabalho com o perfil desejado ou configure o perfil no espaço de trabalho que você está usando. Alterar o hostname na requisição não cria o perfil.

Para outras falhas de requisição e de tarefa, consulte Erros da API de CAPTCHA.