O token e a loja

Duas rotas que qualquer token da loja chama, sem escopo.

`GET /token`

Quem está chamando. Serve para conferir a configuração antes de começar, e é o "quem sou eu" do CLI de temas.

{
  "integration": {
    "id": "0b6f6c3e-...",
    "name": "ERP da loja",
    "api_version": "2026-10",
    "created_at": "2026-10-02T17:30:00.000Z"
  },
  "token": {
    "id": "9a1d2f4b-...",
    "expires_at": null,
    "created_at": "2026-10-02T17:30:00.000Z"
  },
  "session": null,
  "user": null,
  "scopes": ["write_products", "read_orders"],
  "shop_id": "d47e7df1-...",
  "rate_limit": {
    "bucket_size": 40,
    "refill_per_second": 4,
    "expires_at": null
  }
}

scopes traz os escopos marcados no painel. Os de escrita incluem os de leitura: com write_products, as rotas de read_products também respondem.
expires_at é null quando o token não tem validade.
rate_limit é o balde de chamadas da integração (ver Limites). Com o limite ampliado pela Denaryx, como na carga inicial, rate_limit.expires_at diz quando ele volta ao padrão; null sem prazo.

Com o token de uma sessão do CLI (o denaryx login pela conta da pessoa, ver Autenticação), integration vem null, session traz o aparelho e user a pessoa. Os escopos são os que o papel dela na loja dá agora, lidos a cada chamada:

{
  "integration": null,
  "token": {
    "id": "5c2e7a10-...",
    "expires_at": "2027-01-02T21:00:00.000Z",
    "created_at": "2026-10-04T21:00:00.000Z"
  },
  "session": {
    "id": "5c2e7a10-...",
    "device": "notebook-da-ana (denaryx 0.5.0)",
    "created_at": "2026-10-04T21:00:00.000Z",
    "expires_at": "2027-01-02T21:00:00.000Z"
  },
  "user": { "id": "8f3b0c2d-...", "email": "ana@agencia.com.br" },
  "scopes": ["read_themes", "write_themes"],
  "shop_id": "d47e7df1-...",
  "rate_limit": {
    "bucket_size": 40,
    "refill_per_second": 4,
    "expires_at": null
  }
}

`GET /shop`

A loja do token.

{
  "id": "d47e7df1-...",
  "name": "Loja Exemplo",
  "subdomain": "loja-exemplo",
  "storefront_url": "https://www.lojaexemplo.com.br/",
  "domain": "www.lojaexemplo.com.br",
  "currency": "BRL",
  "timezone": "America/Sao_Paulo",
  "locale": "pt-BR",
  "created_at": "2026-09-14T12:00:00.000Z"
}

storefront_url é o endereço principal da vitrine: o domínio próprio, quando verificado, ou o endereço da loja na plataforma.
domain é o domínio próprio verificado, ou null.
Os valores em dinheiro de toda a API são inteiros em centavos de currency.