O token e a loja
Endereço base: https://api.denaryx.com/admin/2026-10. Exemplos e regras no guia O token e a loja. Os erros seguem o formato comum. A especificação inteira: baixar o OpenAPI.
GET /token
O token que faz a chamada
Escopo Qualquer token da loja
A integração, o token, os escopos marcados no painel, a versão e o limite de chamadas. Serve para conferir a configuração antes de começar. Com o token de uma sessão do CLI (o login pela conta da pessoa), integration vem null, session traz o aparelho e user a pessoa, e os escopos são os que o papel dela na loja dá agora.
Resposta
200 Sucesso. (Token)
Os campos da resposta (24)
| Campo | Tipo | Descrição |
|---|---|---|
integration | objeto ou null | |
integration.id | string (uuid) | |
integration.name | string | |
integration.api_version | string | Um de: 2026-10. |
integration.approval_mode | string | Um de: direct, proposal. |
integration.created_at | string (data e hora) | |
token | objeto | |
token.id | string (uuid) | |
token.expires_at | string (data e hora) ou null | |
token.created_at | string (data e hora) | |
session | objeto ou null | |
session.id | string (uuid) | |
session.device | string | |
session.created_at | string (data e hora) | |
session.expires_at | string (data e hora) | |
user | objeto ou null | |
user.id | string (uuid) | |
user.email | string ou null | |
scopes | lista de string | Um de: read_products, write_products, read_content, write_content, read_orders, write_orders, refund_orders, read_themes, write_themes, publish_themes, read_customers, read_reports. |
shop_id | string (uuid) | |
rate_limit | objeto | |
rate_limit.bucket_size | integer | |
rate_limit.refill_per_second | number | |
rate_limit.expires_at | string (data e hora) ou null |
Erros
401O token falta, não existe, foi revogado ou venceu (authentication_error).403O token não tem o escopo da rota, ou, com write_content, mandou campos que pedem write_products, listados em fields (permission_error).429Chamadas demais: espere o Retry-After (rate_limited).500Erro do nosso lado (api_error).503A API está ocupada com outras chamadas: espere o Retry-After (api_error).
GET /shop
A loja do token
Escopo Qualquer token da loja
O nome, os endereços, a moeda e o fuso da loja. Os valores em dinheiro da API são inteiros em centavos da moeda da loja.
Resposta
200 Sucesso. (Shop)
Os campos da resposta (9)
| Campo | Tipo | Descrição |
|---|---|---|
id | string (uuid) | |
name | string | |
subdomain | string | |
storefront_url | string (URL) | |
domain | string ou null | |
currency | "BRL" | |
timezone | "America/Sao_Paulo" | |
locale | "pt-BR" | |
created_at | string (data e hora) |
Erros
401O token falta, não existe, foi revogado ou venceu (authentication_error).403O token não tem o escopo da rota, ou, com write_content, mandou campos que pedem write_products, listados em fields (permission_error).429Chamadas demais: espere o Retry-After (rate_limited).500Erro do nosso lado (api_error).503A API está ocupada com outras chamadas: espere o Retry-After (api_error).