API atual/Referência completa/Theme Builder

Ordem e visibilidade das seções

Reordena as seções e liga ou desliga a visibilidade de uma seção.

Duas operações rápidas que não mexem nos valores da seção: mudar a ordem e esconder ou mostrar.

Reordenar seções

A seção na posição 0 do array vira a primeira, e assim por diante. A rota não verifica se as seções são do mesmo modelo: envie sempre todos os ids do modelo ou grupo, na ordem final.

PUT/api/v1/admin/theme-builder/template-sections/reorderAdmin

Reordenar seções

Requer o privilégio manage_theme.

Corpo da requisição

idsuuid[]obrigatório

Ids das seções na ordem desejada. Não pode ser vazio.

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/admin/theme-builder/template-sections/reorder" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "3d4dfa54-1a77-403d-b447-19d10718fe56",
      "f5f5f5f5-0000-4000-8000-000000000005"
    ]
  }'

Resposta

200Reordenadas

json

{
  "message": "sections reordered"
}

Erros

Status	Quando	Corpo de exemplo
400	Corpo JSON inválido.	`{"error":"invalid request body","detail":"unexpected EOF"}`
400	`ids` vazio.	`{"error":"ids array is required"}`
401	Sem token, token inválido ou expirado.	`{"error":"invalid or expired token"}`
403	Seu usuário não tem o privilégio `manage_theme`.	`{"error":"insufficient privileges","required":"manage_theme"}`
500	Falha de banco de dados ou dado inválido para a coluna.	`{"error":"failed to reorder sections","detail":"..."}`

Alternar visibilidade

Inverte o campo visible: visível vira escondida e vice-versa. Não há corpo e a resposta não informa o novo valor; leia a seção depois se precisar.

PUT/api/v1/admin/theme-builder/template-sections/{id}/toggleAdmin

Alternar a visibilidade de uma seção

Requer o privilégio manage_theme.

Parâmetros de caminho

iduuidobrigatório

Id da seção inserida.

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/admin/theme-builder/template-sections/3d4dfa54-1a77-403d-b447-19d10718fe56/toggle" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Alternada

json

{
  "message": "section visibility toggled"
}

Erros

Status	Quando	Corpo de exemplo
401	Sem token, token inválido ou expirado.	`{"error":"invalid or expired token"}`
403	Seu usuário não tem o privilégio `manage_theme`.	`{"error":"insufficient privileges","required":"manage_theme"}`
404	Seção não existe.	`{"error":"template section not found","detail":"not found: ..."}`
500	Falha de banco de dados ou dado inválido para a coluna.	`{"error":"failed to toggle section visibility","detail":"..."}`

Veja também

Ordem e visibilidade das seções

Reordena as seções e liga ou desliga a visibilidade de uma seção.

Duas operações rápidas que não mexem nos valores da seção: mudar a ordem e esconder ou mostrar.

Reordenar seções

A seção na posição 0 do array vira a primeira, e assim por diante. A rota não verifica se as seções são do mesmo modelo: envie sempre todos os ids do modelo ou grupo, na ordem final.

PUT/api/v1/admin/theme-builder/template-sections/reorderAdmin

Reordenar seções

Requer o privilégio manage_theme.

Corpo da requisição

idsuuid[]obrigatório

Ids das seções na ordem desejada. Não pode ser vazio.

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/admin/theme-builder/template-sections/reorder" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "3d4dfa54-1a77-403d-b447-19d10718fe56",
      "f5f5f5f5-0000-4000-8000-000000000005"
    ]
  }'

Resposta

200Reordenadas

json

{
  "message": "sections reordered"
}

Erros

Status	Quando	Corpo de exemplo
400	Corpo JSON inválido.	`{"error":"invalid request body","detail":"unexpected EOF"}`
400	`ids` vazio.	`{"error":"ids array is required"}`
401	Sem token, token inválido ou expirado.	`{"error":"invalid or expired token"}`
403	Seu usuário não tem o privilégio `manage_theme`.	`{"error":"insufficient privileges","required":"manage_theme"}`
500	Falha de banco de dados ou dado inválido para a coluna.	`{"error":"failed to reorder sections","detail":"..."}`

Alternar visibilidade

Inverte o campo visible: visível vira escondida e vice-versa. Não há corpo e a resposta não informa o novo valor; leia a seção depois se precisar.

PUT/api/v1/admin/theme-builder/template-sections/{id}/toggleAdmin

Alternar a visibilidade de uma seção

Requer o privilégio manage_theme.

Parâmetros de caminho

iduuidobrigatório

Id da seção inserida.

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/admin/theme-builder/template-sections/3d4dfa54-1a77-403d-b447-19d10718fe56/toggle" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Alternada

json

{
  "message": "section visibility toggled"
}

Erros

Status	Quando	Corpo de exemplo
401	Sem token, token inválido ou expirado.	`{"error":"invalid or expired token"}`
403	Seu usuário não tem o privilégio `manage_theme`.	`{"error":"insufficient privileges","required":"manage_theme"}`
404	Seção não existe.	`{"error":"template section not found","detail":"not found: ..."}`
500	Falha de banco de dados ou dado inválido para a coluna.	`{"error":"failed to toggle section visibility","detail":"..."}`