Configura as boas-vindas
PUT/api/welcome/settings
- Auth
- Token erforderlich
- Wer darf:
- owner
- admin
- 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.
Só owner e admin. Parcial: o que não vem fica como está; `screens` substitui a lista (de 1 a 5 telas para ligar; as missões dos "Primeiros passos" vêm nos campos `missions*` e `finalBadgeId`; mantenha o `id` de cada tela ao editar). Ligar (`enabled: true` quando estava desligada) marca `enabledAt` e grava `applyToExisting` como veio (falso se não vier). Desligar deixa os pendentes entrarem direto; ligar de novo não pede de novo a quem já concluiu ou pulou. Erros por campo com 422 em `screens[i].<campo>`.
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 |
|---|---|---|
enabledoptional | boolean | |
modeoptional | REQUIRED | SKIPPABLE | |
applyToExistingoptional | boolean | |
missionsEnabledoptional | boolean | |
missionsShowExistingoptional | boolean | |
finalBadgeIdoptional | string (uuid) | |
missionsoptional | object[] | Substitui a lista (de 1 a 6 para ligar). Mantenha o `id` ao editar: a missão com o mesmo tipo e item continua cumprida por quem já fez; uma nova ou alterada conta a partir de agora. |
missions[].idoptional | string (uuid) | |
missions[].kindPflicht | profile_completed | first_post | form_submitted | event_registered | course_completed | |
missions[].titlePflicht | string | max 80 |
missions[].spaceIdoptional | string (uuid) | |
missions[].formIdoptional | string (uuid) | |
missions[].eventIdoptional | string (uuid) | |
missions[].courseIdoptional | string (uuid) | |
missions[].pointsoptional | integer | ≥ 0, ≤ 10000 |
missions[].badgeIdoptional | string (uuid) | |
screensoptional | object[] | |
screens[].idoptional | string (uuid) | |
screens[].titleoptional | string | max 120 |
screens[].bodyoptional | string | |
screens[].videooptional | object | |
screens[].video.mediaIdoptional | string (uuid) | |
screens[].video.urloptional | string | |
screens[].video.requireFinishoptional | boolean | |
screens[].rulesoptional | object | |
screens[].rules.textoptional | string | |
screens[].fieldIdsoptional | string (uuid)[] |
Antworten
| Status | Beschreibung |
|---|---|
200 | A configuração salva. |
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. |
422 | Tela inválida (título, texto, vídeo, regras, campo de outra comunidade), mais de 5 telas, ou ligar sem tela; missão inválida em `missions[i].<campo>` (tipo, título, item de outra comunidade, pontos, badge), mais de 6, ou ligar sem missão. |
curl-Beispiel
curl -X PUT "https://api.memberfy.net/api/welcome/settings" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{}'