Edita um rascunho
PUT/api/campaigns/{id}
- 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.
Owner, admin, moderador e financeiro. Só rascunho (outro estado devolve 409). Todos os campos são opcionais; `blocks` e `audience` substituem o valor inteiro.
Parameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
idPflicht | path | string (uuid) |
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 200 |
subjectoptional | string | max 300 |
preheaderoptional | string | max 300 |
blocksoptional | object[] | |
blocks[].typePflicht | text | button | image | |
blocks[].htmloptional | string | Só em `text`. HTML rico, sanitizado como nos posts. `{{nome}}` vira o primeiro nome de cada pessoa. |
blocks[].textoptional | string | Só em `button`. · max 80 |
blocks[].urloptional | string | Em `button` (destino) e `image` (endereço da imagem). Só http ou https. |
blocks[].altoptional | string | Só em `image`. · max 200 |
audienceoptional | object | Público: a união de todos os critérios, cada pessoa uma vez. Quem se descadastrou, teve bounce permanente ou reclamou nunca entra. |
audience.alloptional | boolean | Toda a base da comunidade. |
audience.groupIdsoptional | string (uuid)[] | |
audience.tagsoptional | string[] | Nomes das tags. |
audience.profileIdsoptional | string (uuid)[] | Pessoas escolhidas na mão. Quem se descadastrou é recusado com erro no campo `audience.profileIds`. |
Antworten
| Status | Beschreibung |
|---|---|
200 | Rascunho atualizado. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou expirado. |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Recurso não encontrado. |
409 | Conflito com o estado atual do recurso. |
422 | Bloco inválido, pessoa que não é da comunidade ou que se descadastrou. |
500 | Erro interno do servidor. |
curl-Beispiel
curl -X PUT "https://api.memberfy.net/api/campaigns/<id>" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{}'