Eventos
Endereço base: https://api.denaryx.com/admin/2026-10. Exemplos e regras no guia Eventos. Os erros seguem o formato comum. A especificação inteira: baixar o OpenAPI.
GET /events
Os eventos da loja dos últimos 30 dias
Escopo read_products ou read_orders ou read_themes ou read_customers
O que mudou nos pedidos, no catálogo, nos temas e nas contas dos clientes, do mais antigo ao mais novo, só dos tipos que os escopos do token alcançam (os pedidos pedem read_orders; os produtos e o estoque, read_products; os temas, read_themes; os clientes, read_customers). Cada evento traz só o resumo (o id do recurso e o que cabe sem dado pessoal): para o recurso inteiro, consulte a rota dele. Serve para recuperar o que um webhook perdeu.
Parâmetros
| Nome | Onde | Tipo | Descrição |
|---|---|---|---|
limit | consulta | integer | Quantos itens por página, de 1 a 100 (50 sem ele). |
cursor | consulta | string | O next_cursor da página anterior, como veio. Os filtros continuam os mesmos. |
types | consulta | string | Só estes tipos, separados por vírgula: order.created, order.paid, order.updated, order.shipped, order.delivered, order.cancelled, order.anonymized, order.prescription_received, product.created, product.updated, product.deleted, inventory.updated, theme.published, customer.created, customer.updated, customer.deleted. |
created_at_min | consulta | string (data e hora) | Só o criado a partir desta data (ISO 8601). |
resource_id | consulta | string (uuid) | Só os eventos deste recurso (o id do pedido, do produto, da variante, do tema ou do cliente). |
Resposta
200 Sucesso. (EventList)
Os campos da resposta (13)
| Campo | Tipo | Descrição |
|---|---|---|
data | lista de objeto | |
data[].id | string (uuid) | |
data[].type | string | Um de: order.created, order.paid, order.updated, order.shipped, order.delivered, order.cancelled, order.anonymized, order.prescription_received, product.created, product.updated, product.deleted, inventory.updated, theme.published, customer.created, customer.updated, customer.deleted. |
data[].created_at | string (data e hora) | |
data[].api_version | string | Um de: 2026-10. |
data[].data | objeto | |
data[].data.id | string (uuid) | O id do recurso: o pedido, o produto, a variante, o tema ou o cliente. |
data[].data.number | integer | Nos eventos de pedido: o número do pedido na loja. |
data[].data.status | string | Nos eventos de pedido (menos order.anonymized): a situação depois da mudança.Um de: pending_payment, paid, preparing, shipped, delivered, cancelled. |
data[].data.line_item_id | string (uuid) | Em order.prescription_received: o item do pedido cuja receita chegou. A receita mesmo só sai no GET do pedido. |
data[].data.product_id | string (uuid) | Em inventory.updated: o produto da variante. |
data[].data.inventory_quantity | integer | Em inventory.updated: o estoque depois da mudança. |
next_cursor | string ou null |
Erros
400A chamada veio com campos inválidos; os campos recusados vão em fields (invalid_request).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).