API atual/Referência completa/Temas da vitrine

Histórico de estilos

Lista as versões anteriores dos estilos de um tema e restaura uma delas.

Sempre que um estilo é alterado, a plataforma guarda uma cópia do estado anterior. O histórico serve para desfazer uma mudança de cor ou de CSS. Exige o privilégio manage_theme.

Listar o histórico

GET/api/v1/admin/storefront-themes/{id}/style-historyAdmin

Lista as últimas alterações de estilo de um tema

Devolve as 20 entradas mais recentes de todos os estilos do tema, da mais nova para a mais antiga. Não há paginação nem parâmetro de limite.

Parâmetros de caminho

iduuidobrigatório

Id do tema.

200Histórico retornado

json

{
  "entries": [
    {
      "id": "a8043728-96d7-478f-a79f-930b0da5aeda",
      "style_id": "cd9e5a33-508e-4c69-8e85-85e20f3ad712",
      "theme_id": "a650691c-22f3-4508-9a83-9418c04976a6",
      "name": "Runner",
      "snapshot": {
        "name": "Runner",
        "primary_color": "#2563eb",
        "secondary_color": "#2563eb",
        "font_family": "Inter, sans-serif",
        "border_radius": "8px",
        "custom_css": ""
      },
      "note": "Style updated",
      "created_at": "2026-08-02T04:49:40.256746Z"
    }
  ],
  "total": 1
}

Campos da resposta

entries[].iduuid

Identificador da entrada. É o historyId da restauração.

entries[].style_iduuid

Estilo a que a entrada pertence.

entries[].theme_iduuid

Tema do estilo.

entries[].namestring

Nome do estilo naquele momento.

entries[].snapshotobject

Estado completo do estilo antes da alteração, com os mesmos campos de Criar estilo (o exemplo mostra só alguns).

entries[].notestring

Motivo do registro, por exemplo Style updated.

entries[].created_atstring

Momento do registro (RFC 3339, UTC).

totalinteger

Quantidade de entradas devolvidas.

Restaurar uma versão

POST/api/v1/admin/storefront-themes/style-history/{historyId}/restoreAdmin

Reaplica uma versão antiga sobre o estilo

Reescreve o estilo original com o conteúdo da entrada. O estado atual do estilo também é guardado no histórico antes, então a restauração pode ser desfeita. O estilo precisa ainda existir.

Parâmetros de caminho

historyIduuidobrigatório

Id da entrada do histórico.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/admin/storefront-themes/style-history/$HISTORY_ID/restore" \
  -H "Authorization: Bearer $TOKEN"

A resposta 200 é o estilo já restaurado, no formato de Listar estilos.

Erros

Status	Quando	Corpo
401	Sem token ou token expirado	`{"error":"missing authorization header"}`
403	Sem o privilégio `manage_theme`	`{"error":"insufficient privileges","required":"manage_theme"}`
404	O estilo da entrada foi excluído	`{"error":"not found","detail":"registro não existe mais: not found"}`
409	O estilo pertence a um patch aplicado	`{"error":"...","code":"patch_owned"}`
500	Entrada inexistente ou `id` que não é UUID	`{"error":"failed to restore style history","detail":"history entry not found: ..."}`

Veja também

Histórico de estilos

Lista as versões anteriores dos estilos de um tema e restaura uma delas.

Sempre que um estilo é alterado, a plataforma guarda uma cópia do estado anterior. O histórico serve para desfazer uma mudança de cor ou de CSS. Exige o privilégio manage_theme.

Listar o histórico

GET/api/v1/admin/storefront-themes/{id}/style-historyAdmin

Lista as últimas alterações de estilo de um tema

Devolve as 20 entradas mais recentes de todos os estilos do tema, da mais nova para a mais antiga. Não há paginação nem parâmetro de limite.

Parâmetros de caminho

iduuidobrigatório

Id do tema.

200Histórico retornado

json

{
  "entries": [
    {
      "id": "a8043728-96d7-478f-a79f-930b0da5aeda",
      "style_id": "cd9e5a33-508e-4c69-8e85-85e20f3ad712",
      "theme_id": "a650691c-22f3-4508-9a83-9418c04976a6",
      "name": "Runner",
      "snapshot": {
        "name": "Runner",
        "primary_color": "#2563eb",
        "secondary_color": "#2563eb",
        "font_family": "Inter, sans-serif",
        "border_radius": "8px",
        "custom_css": ""
      },
      "note": "Style updated",
      "created_at": "2026-08-02T04:49:40.256746Z"
    }
  ],
  "total": 1
}

Campos da resposta

entries[].iduuid

Identificador da entrada. É o historyId da restauração.

entries[].style_iduuid

Estilo a que a entrada pertence.

entries[].theme_iduuid

Tema do estilo.

entries[].namestring

Nome do estilo naquele momento.

entries[].snapshotobject

Estado completo do estilo antes da alteração, com os mesmos campos de Criar estilo (o exemplo mostra só alguns).

entries[].notestring

Motivo do registro, por exemplo Style updated.

entries[].created_atstring

Momento do registro (RFC 3339, UTC).

totalinteger

Quantidade de entradas devolvidas.

Restaurar uma versão

POST/api/v1/admin/storefront-themes/style-history/{historyId}/restoreAdmin

Reaplica uma versão antiga sobre o estilo

Reescreve o estilo original com o conteúdo da entrada. O estado atual do estilo também é guardado no histórico antes, então a restauração pode ser desfeita. O estilo precisa ainda existir.

Parâmetros de caminho

historyIduuidobrigatório

Id da entrada do histórico.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/admin/storefront-themes/style-history/$HISTORY_ID/restore" \
  -H "Authorization: Bearer $TOKEN"

A resposta 200 é o estilo já restaurado, no formato de Listar estilos.

Erros

Status	Quando	Corpo
401	Sem token ou token expirado	`{"error":"missing authorization header"}`
403	Sem o privilégio `manage_theme`	`{"error":"insufficient privileges","required":"manage_theme"}`
404	O estilo da entrada foi excluído	`{"error":"not found","detail":"registro não existe mais: not found"}`
409	O estilo pertence a um patch aplicado	`{"error":"...","code":"patch_owned"}`
500	Entrada inexistente ou `id` que não é UUID	`{"error":"failed to restore style history","detail":"history entry not found: ..."}`