API Admin › Recursos

Eventos

O registro do que mudou na loja nos últimos 30 dias: os pedidos, os produtos, o estoque, os temas e as contas dos clientes. São os mesmos eventos que os webhooks entregam, guardados para consulta. Servem para recuperar o que um webhook perdeu (o servidor da integração fora do ar, o webhook desligado) e para conferir o que aconteceu com um pedido ou um produto.

Escopo	O que abre
`read_orders`, `read_products`, `read_themes` ou `read_customers`	os eventos dos recursos que os escopos do token alcançam

O token vê só os tipos que os escopos dele alcançam: com read_products, os eventos de produto e de estoque; com read_orders, os de pedido; com read_themes, o theme.published; com read_customers, os de cliente. Os eventos são gravados a partir do momento em que a loja tem uma integração ativa.

O objeto evento

{
  "id": "2f6c0a8e-...",
  "type": "order.paid",
  "created_at": "2026-10-04T13:20:00.000Z",
  "api_version": "2026-10",
  "data": {
    "id": "6c1d0a52-...",
    "number": 1021,
    "status": "paid"
  }
}

id é o mesmo id do evento que vai no webhook (Denaryx-Event-Id).
data é um resumo do momento da mudança, sem dado pessoal: o id do recurso (o pedido, o produto, a variante, o tema ou a conta do cliente) e, conforme o tipo:
- nos eventos de pedido, o number e o status depois da mudança (o order.anonymized traz só o number; o order.prescription_received, o number e o line_item_id do item cuja receita chegou);
- no inventory.updated, o product_id e o inventory_quantity depois da mudança.

Para o recurso inteiro, consulte a rota dele (GET /orders/{id}, GET /products/{id}, GET /variants?ids=, GET /themes/{id}). Os tipos estão na tabela de Webhooks.

`GET /events`

Do mais antigo ao mais novo (pela data, com o id para desempatar), com o cursor das listas.

Parâmetro	O que faz
`limit`	de 1 a 100 (50 sem ele)
`cursor`	o `next_cursor` da página anterior
`types`	só estes tipos, separados por vírgula: `order.paid,order.cancelled`
`created_at_min`	só os eventos a partir desta data (ISO 8601)
`resource_id`	só os eventos de um recurso: tudo o que aconteceu com um pedido, por exemplo

curl "https://api.denaryx.com/admin/2026-10/events?types=order.paid,order.cancelled&created_at_min=2026-10-04T00:00:00Z" \
  -H "Authorization: Bearer dnxa_..."

{
  "data": [
    {
      "id": "2f6c0a8e-...",
      "type": "order.paid",
      "created_at": "2026-10-04T13:20:00.000Z",
      "api_version": "2026-10",
      "data": { "id": "6c1d0a52-...", "number": 1021, "status": "paid" }
    }
  ],
  "next_cursor": null
}

Erros próprios: 400 invalid_request (um tipo desconhecido em types, uma data ou um id inválido).

Recuperar o que um webhook perdeu

Guarde a created_at do último evento que o seu sistema processou.
Ao voltar, peça GET /events?created_at_min=<essa data> com os tipos que interessam, página por página.
Para cada evento novo (pelo id), busque o recurso na rota dele e atualize a sua cópia.

Os eventos ficam 30 dias. Para uma parada maior, refaça a sincronização pelas listas com updated_at_min.