Audácia
← Voltar ao portal Developers
Developers / Comece aqui / Primeiros passos com a API

Primeiros passos com a API V1

URL-base: https://audacia.com.br/api/v1

1. Obtenha um token autorizado

Solicite à pessoa administradora da integração no Audácia uma credencial com as permissões necessárias. O token é vinculado a uma empresa e não é gerado por cadastro público OAuth.

2. Verifique a API pública

curl -i 'https://audacia.com.br/api/v1/health' -H 'Accept: application/json'

Esse endpoint informa conectividade HTTP básica. Ele não exige token e não verifica o funcionamento integral de módulos.

3. Confira o token

curl -i 'https://audacia.com.br/api/v1/me' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer SEU_TOKEN'

Não compartilhe tokens em documentos, URLs, tickets ou imagens. Guarde o segredo no servidor.

4. Consulte um recurso autorizado

curl -i 'https://audacia.com.br/api/v1/products?per_page=20' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer SEU_TOKEN'

Este recurso exige products.read. Se a integração não possuir essa permissão, solicite revisão de acesso em vez de tentar usar credenciais de um usuário.