Salva um tema da comunidade ("Usar este tema", "Personalizar" › Salvar, "Duplicar")
POST/api/community-themes
- Auth
- Token erforderlich
- X-CommunityId
X-CommunityIdSende die X-CommunityId der Community, in der die Operation stattfindet.
Die Beschreibungen der Endpoints stammen aus der API-Spezifikation und sind vorerst auf Portugiesisch. Die Oberfläche drumherum ist übersetzt.
Ponto de partida: um tema pronto (`presetKey`, com a navigation do tema ativo), um tema salvo (`sourceThemeId`, o Duplicar; aceita `active`) ou, sem os dois, o tema ativo. `values` (parcial) vai por cima. `name` padrão: o nome do pronto, ou "<origem> personalizado". `activate: true` também o ativa (o "Usar este tema"), com o efeito de `POST /api/community-themes/{id}/activate`.
422: no 11º tema (`communityThemes.limitReached`), `presetKey` desconhecido, valor fora da lista ou cor inválida (um item por campo em `errors`), e modo diferente de `light` sem o tema escuro liberado. 400 com `presetKey` e `sourceThemeId` juntos. Vai para o histórico da comunidade (campo "tema"). Owner e admin.
Header
| Name | Typ | Beschreibung |
|---|---|---|
X-CommunityIdoptional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Request-Body application/json
| Name | Typ | Beschreibung |
|---|---|---|
nameoptional | string | max 80 |
presetKeyoptional | light | dark | dark-premium | ocean | forest | editorial | |
sourceThemeIdoptional | string | Id de um tema salvo, ou `active`. |
valuesoptional | object | Os valores de um tema: tudo o que é aparência da comunidade. Sempre completos na resposta. Na escrita (`values` em `POST` e `PATCH`), parciais: o que não vem fica como está. Numa escala, os tons que não vêm são derivados do 500 enviado (como "Gerar tons"); sem o 500, ficam os de antes. Cor que não é hexadecimal, fonte, cantos, densidade, modo, estado do menu, `navigation.layout` ou elemento de `navigation.hiddenNative` fora da lista → 422 com `param` no campo (por exemplo `values.font.heading` ou `values.navigation.hiddenNative[1]`). |
values.modeoptional | light | dark | auto | `dark` e `auto` só com o tema escuro liberado (`darkModeAllowed`); senão, 422 com `param = values.mode`. |
values.lightoptional | object | As cores de um lado do tema (claro ou escuro). |
values.light.primaryoptional | object | Escala inteira (50 a 950). No escuro, `null` = gerada do claro. |
values.light.secondaryoptional | object | Escala inteira (50 a 950). No escuro, `null` = gerada do claro. |
values.light.sidebarBgoptional | string | Fundo do menu lateral; `null` = a superfície padrão. |
values.light.sidebarTextoptional | string | Texto do menu lateral; `null` = o texto padrão. |
values.light.headerBgoptional | string | Fundo do cabeçalho; `null` = a superfície padrão. |
values.light.headerTextoptional | string | Texto do cabeçalho; `null` = o texto padrão. |
values.light.browserBaroptional | string | Cor da barra do navegador no celular. A do claro é copiada para o `themeColor` da comunidade. |
values.darkoptional | object | As cores de um lado do tema (claro ou escuro). |
values.dark.primaryoptional | object | Escala inteira (50 a 950). No escuro, `null` = gerada do claro. |
values.dark.secondaryoptional | object | Escala inteira (50 a 950). No escuro, `null` = gerada do claro. |
values.dark.sidebarBgoptional | string | Fundo do menu lateral; `null` = a superfície padrão. |
values.dark.sidebarTextoptional | string | Texto do menu lateral; `null` = o texto padrão. |
values.dark.headerBgoptional | string | Fundo do cabeçalho; `null` = a superfície padrão. |
values.dark.headerTextoptional | string | Texto do cabeçalho; `null` = o texto padrão. |
values.dark.browserBaroptional | string | Cor da barra do navegador no celular. A do claro é copiada para o `themeColor` da comunidade. |
values.fontoptional | object | |
values.font.headingoptional | system | inter | manrope | dm-sans | plus-jakarta-sans | poppins | lora | merriweather | ibm-plex-sans | |
values.font.bodyoptional | system | inter | manrope | dm-sans | plus-jakarta-sans | poppins | lora | merriweather | ibm-plex-sans | |
values.radiusoptional | rounded | soft | square | Arredondados (12 px, padrão), Suaves (6 px) ou Retos. |
values.densityoptional | comfortable | compact | |
values.navigationoptional | object | Ausente nos temas prontos (usar um pronto herda a navegação do tema ativo). |
activateoptional | boolean | |
originoptional | image | Fase 4b: salva a proposta de `POST /api/communities/appearance/theme-from-image` (envie a `values` dela, sem `presetKey` nem `sourceThemeId`); o tema fica com origem `image`, nome padrão "Tema da imagem", e o Restaurar volta à proposta. |
Antworten
| Status | Beschreibung |
|---|---|
201 | O tema salvo. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`). |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Recurso não encontrado. |
422 | Limite de 10 temas, valor fora da lista, cor inválida ou tema escuro sem liberação. |
500 | Erro interno do servidor. |
curl-Beispiel
curl -X POST "https://api.memberfy.net/api/community-themes" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{}'