Denaryx
Nesta documentação

API Admin › Guias

Testar no Postman ou no Insomnia

A forma mais rápida de experimentar a API Admin é importar a especificação num cliente HTTP, como o Postman ou o Insomnia: cada rota vira uma chamada pronta, com os parâmetros e o corpo de exemplo, e o token fica guardado na ferramenta, na sua máquina.

1. Importar a especificação

A especificação OpenAPI da versão 2026-10 é pública, sem token:

https://api.denaryx.com/admin/2026-10/openapi.json

No Postman ou no Insomnia, use Import e cole o endereço (ou baixe o arquivo na referência e importe-o). A ferramenta cria uma coleção com todas as rotas, agrupadas como na referência, e o endereço base https://api.denaryx.com/admin/2026-10.

2. O token numa variável

  1. Crie uma integração no painel da loja, em Configurações › Integrações, só com os escopos que vai testar (ver Autenticação). Uma integração de teste, com validade de 90 dias, é o mais seguro.
  2. Na ferramenta, guarde o token numa variável de ambiente marcada como secreta (por exemplo, token), e não direto na coleção.
  3. Na autorização da coleção, escolha Bearer Token com o valor {{token}}. Toda chamada passa a mandar Authorization: Bearer dnxa_....

O token é segredo de servidor. Não o ponha numa coleção compartilhada, num repositório nem num print; se ele vazar, revogue no painel na hora. A documentação deste site não tem um botão de "testar aqui" de propósito: o token não precisa sair da sua ferramenta, e a API Admin não responde a páginas de outra origem.

3. As primeiras chamadas

GET /token confere a configuração: a integração, os escopos e o limite de chamadas.

curl https://api.denaryx.com/admin/2026-10/token \
  -H "Authorization: Bearer dnxa_..."

GET /shop diz a loja do token: o nome, o subdomínio e o endereço da vitrine (ver O token e a loja).

curl https://api.denaryx.com/admin/2026-10/shop \
  -H "Authorization: Bearer dnxa_..."

Toda resposta traz o cabeçalho Denaryx-Request-Id; guarde-o se algo der errado. A versão vem no caminho (/admin/2026-10/), e o cabeçalho Denaryx-Api-Version confirma qual respondeu (ver Versões).

4. Antes de gravar

  • Os limites valem também aqui: 40 chamadas seguidas por integração, e o balde se enche 4 por segundo. Uma coleção rodada em laço passa a receber 429 com Retry-After (ver Limites).
  • Mande Idempotency-Key nas escritas (um UUID novo a cada uma): repetir a chamada depois de uma queda de rede não grava duas vezes (ver Escrita repetível). As ferramentas têm uma variável de UUID aleatório para isso.
  • Teste numa loja de teste, ou com cuidado: o que a API grava é de verdade (o estoque, o preço, o pedido). Na loja de teste, nenhum pagamento é real, e os pedidos vêm com "test": true. Nos temas, nada vai para a vitrine antes da publicação.