Para desenvolvedores
API Admin da Denaryx
A API Admin é a porta das integrações de uma loja: o ERP que atualiza o estoque e lê os pedidos, o CLI de temas da agência, uma planilha ou automação que trabalha na loja. Ela é separada da API que o painel usa: tem contrato próprio, versionado por data, que não muda sem aviso.
- Endereço:
https://api.denaryx.com/admin/2026-10/.... Não há loja no caminho: o token diz qual é. - JSON em inglês,
snake_case, com os mesmos nomes dos objetos dos temas em Liquid (title,handle,variants,price,sku). As mensagens de erro são em português; os códigos, em inglês. - Dinheiro em centavos, inteiros, na moeda da loja (
currencyemGET /shop). Datas em ISO 8601, em UTC. - Especificação OpenAPI 3.1:
openapi-2026-10.json, também emGET /admin/2026-10/openapi.json, sem token.
Guias
- Autenticação: integrações, tokens e escopos
- Versões
- Erros
- Listas e sincronização
- Limites
- Escrita repetível (Idempotency-Key)
- Webhooks: os eventos, a assinatura, as novas tentativas
- Testar no Postman ou no Insomnia
- Testar numa loja de teste: o pagamento simulado e os pedidos com
test - Servidor MCP: agentes de IA lendo a loja
- Agentes de compra: o feed da OpenAI e o endereço do carrinho
Para temas, o CLI de temas (denaryx) faz o caminho inteiro pela API, inclusive com o login pela conta de quem está na equipe (Autenticação); o guia da agência explica o tema, e O tema no GitHub liga um tema a uma branch, sem CI.
Recursos
| Recurso | Rotas | Escopo |
|---|---|---|
| O token e a loja | GET /token, GET /shop | qualquer token |
| Temas | /themes: arquivos, assets, versões, zip, prévia, conferência e publicação | read_themes, write_themes, publish_themes |
| Produtos, coleções e marcas | /products (variantes e fotos), /variants, /collections, /brands | read_products, write_products |
| Estoque e preço | POST /inventory/adjust, /inventory/set, /prices/set, em lote | write_products |
| Montagens | /assemblies: os complementos de um produto (a lente e os tratamentos) | read_products, write_products |
| Provador virtual | /products/{id}/try_on: os arquivos da armação, por URL | read_products, write_products |
| Pedidos | /orders: a lista, as mudanças de situação e a nota fiscal | read_orders, write_orders, refund_orders |
| Clientes | /customers: as contas da área do cliente, com os endereços salvos | read_customers |
| Relatório de vendas | GET /reports/sales: as vendas por dia, produto ou coleção, sem o comprador | read_reports |
| Relatório de buscas | GET /reports/searches: os termos buscados na vitrine, sem quem buscou | read_products, read_content |
| Eventos | GET /events: o que mudou nos últimos 30 dias | um escopo de leitura (read_...) |
| Webhooks | /webhooks: cadastrar, mudar, testar e trocar o segredo | qualquer token de integração (cada evento pede a leitura dele) |
Primeira chamada
curl https://api.denaryx.com/admin/2026-10/token \
-H "Authorization: Bearer dnxa_..."A resposta diz a integração, os escopos marcados no painel e o limite de chamadas do token.
Referência completa
Cada rota com os escopos, os parâmetros, os campos e os erros, montada da especificação OpenAPI da versão 2026-10.