Pular para o conteúdo
AchaduDevelopers
API operacionalIr para o site
Painel
Achadu/Developers/Ferramentas

Construa e opere sem depender de uma caixa-preta.

Sandbox, observabilidade, aplicativos, automações e testes de contrato rodam no próprio Achadu e usam a mesma fonte de verdade da API.

Contratos e downloads

Postman

Importe a coleção, crie um Environment e defina base_url e api_key. As pastas seguem os mesmos domínios da referência pública.

bash
base_url=https://achadu.com/api/v1
api_key=ach_live_...

Bruno

No Bruno, escolha Import Collection, selecione OpenAPI e informe a URL abaixo. O cliente cria as 121 requisições mantendo parâmetros e corpos de exemplo.

bash
https://achadu.com/api/v1/openapi.json

Sandbox isolado por conta

Chaves ach_test usam dados separados da produção. Você pode alterar os exemplos e restaurar o ambiente sem tocar em ofertas, grupos, receita ou webhooks reais.

Dados prontos

Oferta, cupom, grupo, segmento, template e publicação demonstrativos.

Mesmo contrato

As mesmas rotas, validações, paginação e escopos da produção.

Validade curta

Credenciais de uma hora, um dia ou sete dias.

Restauração

Um clique recria o estado inicial de teste.

bash
curl https://achadu.com/api/v1/offers \
  -H "Authorization: Bearer ach_test_..."

Observabilidade por credencial

A central mostra volume, taxa de sucesso, latência média, erros e solicitações recentes de cada chave. O CSV preserva request_id, rota, status e duração para auditoria.

Retenção90 dias
DetalhePor chave
ExportaçãoCSV
Correlaçãorequest_id
AmbientesLive e sandbox
SegredosNunca registrados

Aplicativos e tokens temporários

Registre um aplicativo na conta, escolha os escopos permitidos e troque Client ID e Client Secret por um token Bearer de uma hora. Revogar o aplicativo encerra todos os tokens emitidos para ele.

bash
curl -X POST https://achadu.com/api/developer/oauth/token \
  -H "Content-Type: application/json" \
  -d '{"client_id":"ach_app_...","client_secret":"ach_secret_...","scope":"offers:read analytics:read"}'

Biblioteca de automações

Receitas nativas combinam gatilho, ações e escopos necessários. Toda instalação começa como rascunho e só executa depois de uma ativação explícita.

Oferta aprovada

Prévia e publicação nos destinos escolhidos.

Cupom atualizado

Atualização editorial da vitrine.

Inbox prioritário

Atribuição de conversas com alta intenção.

Resumo diário

Leitura combinada de publicação, audiência e receita.

Testes de contrato no próprio painel

A validação confere nomes, rotas, métodos, escopos, versões de webhook, domínios e isolamento do sandbox. Cada execução fica registrada com duração e resultado.

Nomes e rotas sem duplicidade.
Toda operação ligada a um escopo válido.
Todos os eventos com schema e versão.
Sandbox separado da produção.
Histórico disponível para auditoria.