API Admin › Referência

Referência da API Admin

Versão 2026-10. Todo endereço começa em https://api.denaryx.com/admin/2026-10 e leva o token da integração em Authorization: Bearer dnxa_... (ver Autenticação). Esta página sai da mesma especificação que a API serve em /openapi.json, sem token, para gerar clientes e importar em ferramentas.

A especificação OpenAPI

Importe num cliente HTTP para chamar a API com o seu token, ou gere um cliente na sua linguagem (ver Testar no Postman ou no Insomnia).

Baixar a especificação (OpenAPI)

O token e a loja

RotaO que fazEscopo
GET /tokenO token que faz a chamadaQualquer token da loja
GET /shopA loja do tokenQualquer token da loja

Temas

RotaO que fazEscopo
GET /themesOs temas da biblioteca da lojaread_themes
POST /themesAcrescenta um tema à bibliotecawrite_themes
POST /themes/importCria um tema a partir de um zipwrite_themes
GET /themes/{id}Um temaread_themes
PATCH /themes/{id}Renomeia um temawrite_themes
DELETE /themes/{id}Exclui um temawrite_themes
GET /themes/{id}/filesOs arquivos de um temaread_themes
PUT /themes/{id}/filesGrava arquivos de texto, tudo ou nadawrite_themes
GET /themes/{id}/files/contentO conteúdo de um arquivoread_themes
POST /themes/{id}/assetsEnvia arquivos para assets/write_themes
GET /themes/{id}/versionsAs versões do códigoread_themes
POST /themes/{id}/versionsGuarda o código de agora como versãowrite_themes
POST /themes/{id}/versions/{version_id}/restoreVolta o código a uma versãowrite_themes
POST /themes/{id}/importTroca os arquivos de um tema pelos de um zipwrite_themes
GET /themes/{id}/exportO zip do código de um temaread_themes
POST /themes/{id}/previewsUma prévia do tema na vitrinewrite_themes
GET /themes/{id}/checkO que muda se o tema for publicadoread_themes
POST /themes/{id}/publishPublica o temapublish_themes

Produtos e variantes

RotaO que fazEscopo
GET /productsOs produtos da lojaread_products ou read_content
POST /productsCria um produtowrite_products
GET /products/countQuantos produtos casam com os filtrosread_products ou read_content
GET /products/{id}Um produtoread_products ou read_content
PATCH /products/{id}Muda campos de um produtowrite_products ou write_content
DELETE /products/{id}Exclui um produtowrite_products
POST /products/{id}/variantsAcrescenta uma variantewrite_products
PATCH /products/{id}/variants/{variant_id}Muda campos de uma variantewrite_products
DELETE /products/{id}/variants/{variant_id}Exclui uma variantewrite_products
GET /variantsAs variantes da lojaread_products
POST /products/{id}/imagesAcrescenta uma fotowrite_products
PATCH /products/{id}/images/{image_id}Muda o texto de uma fotowrite_products ou write_content
DELETE /products/{id}/images/{image_id}Exclui uma fotowrite_products
GET /products/{id}/try_onO provador virtual do produtoread_products
PUT /products/{id}/try_onGrava o provador virtual do produtowrite_products
DELETE /products/{id}/try_onTira o provador virtual do produtowrite_products
GET /products/{id}/variants/{variant_id}/try_onO provador virtual da varianteread_products
PUT /products/{id}/variants/{variant_id}/try_onGrava o provador virtual da variantewrite_products
DELETE /products/{id}/variants/{variant_id}/try_onTira o provador virtual da variantewrite_products

Coleções e marcas

RotaO que fazEscopo
GET /collectionsAs coleções da lojaread_products ou read_content
POST /collectionsCria uma coleçãowrite_products
GET /collections/{id}Uma coleçãoread_products ou read_content
PATCH /collections/{id}Muda campos de uma coleçãowrite_products ou write_content
DELETE /collections/{id}Exclui uma coleçãowrite_products
GET /brandsAs marcas da lojaread_products ou read_content
POST /brandsCria uma marcawrite_products
GET /brands/{id}Uma marcaread_products ou read_content
PATCH /brands/{id}Muda campos de uma marcawrite_products ou write_content
DELETE /brands/{id}Exclui uma marcawrite_products

Montagens

RotaO que fazEscopo
GET /assembliesAs montagens da lojaread_products
POST /assembliesCria uma montagemwrite_products
GET /assemblies/{id}Uma montagemread_products
PATCH /assemblies/{id}Muda campos de uma montagemwrite_products
DELETE /assemblies/{id}Exclui uma montagemwrite_products

Páginas

RotaO que fazEscopo
GET /pagesAs páginas da lojaread_content
POST /pagesCria uma páginawrite_content
GET /pages/{id}Uma páginaread_content
PATCH /pages/{id}Muda campos de uma páginawrite_content

Propostas

RotaO que fazEscopo
GET /proposalsAs propostas desta integraçãowrite_products ou write_content
GET /proposals/{id}Uma propostawrite_products ou write_content

Estoque e preço

RotaO que fazEscopo
POST /inventory/adjustSoma ao estoque, em lotewrite_products
POST /inventory/setGrava o estoque, em lotewrite_products
POST /prices/setGrava preços, em lotewrite_products

Pedidos

RotaO que fazEscopo
GET /ordersOs pedidos da lojaread_orders
GET /orders/countQuantos pedidos casam com os filtrosread_orders
GET /orders/{id}Um pedidoread_orders
POST /orders/{id}/mark_paidMarca o pedido como pagowrite_orders
POST /orders/{id}/prepareComeça a separar o pedidowrite_orders
POST /orders/{id}/shipMarca o pedido como enviadowrite_orders
POST /orders/{id}/deliverMarca o pedido como entreguewrite_orders
POST /orders/{id}/cancelCancela o pedidowrite_orders
PUT /orders/{id}/invoiceInforma a nota fiscal do pedidowrite_orders
PUT /orders/{id}/line_items/{line_id}/prescriptionInforma a receita de um itemwrite_orders
POST /orders/{id}/line_items/{line_id}/prescription/checkMarca a receita de um item como conferidawrite_orders

Clientes

RotaO que fazEscopo
GET /customersOs clientes da lojaread_customers
GET /customers/{id}Um clienteread_customers

Relatórios

RotaO que fazEscopo
GET /reports/salesAs vendas do períodoread_reports
GET /reports/searchesAs buscas da vitrine no períodoread_products ou read_content

Eventos

RotaO que fazEscopo
GET /eventsOs eventos da loja dos últimos 30 diasread_products ou read_orders ou read_themes ou read_customers

Webhooks

RotaO que fazEscopo
GET /webhooksOs webhooks da integraçãoQualquer token da loja
POST /webhooksCadastra um webhookQualquer token da loja
GET /webhooks/{id}Um webhookQualquer token da loja
PATCH /webhooks/{id}Muda um webhookQualquer token da loja
DELETE /webhooks/{id}Exclui um webhookQualquer token da loja
POST /webhooks/{id}/testEnvia um evento de testeQualquer token da loja

Eventos dos webhooks

O POST que chega ao endereço do webhook, assinado. Ver Webhooks.