Pular para o conteúdo
AchaduDevelopers
API operacionalIr para o site
Painel
Achadu/Developers/Início rápido

Sua primeira integração em cinco minutos.

Gere uma chave, valide a conta e faça a primeira consulta sem instalar um SDK.

Antes de começar

Uma conta Achadu no plano Profissional ou superior.
Acesso de administradora à área de desenvolvedores.
Um cliente HTTP como curl, Bruno, Postman ou seu runtime preferido.
01

Crie uma chave dedicada.

Dê um nome que identifique o aplicativo, defina a validade e selecione apenas os escopos necessários. O segredo completo aparece uma única vez.

Gerar chave no painel
02

Valide a identidade da conta.

A primeira chamada recomendada é GET /me. Ela confirma qual operação e qual ator estão vinculados à chave.

bash
curl https://achadu.com/api/v1/me \
  -H "Authorization: Bearer ach_live_..." \
  -H "Accept: application/json"
03

Prepare para produção.

Guarde a chave em um cofre de segredos, nunca no código-fonte.
Registre o x-request-id de respostas com erro.
Implemente backoff para respostas 429 e falhas transitórias.
Use uma chave separada para cada aplicativo ou ambiente.