Quem confirmou e quem não confirmou a leitura de um post
GET/api/content/{id}/acknowledgements
- Auth
- Exige token
- Chave de API:
- content:read
- X-CommunityId
X-CommunityIdEnvie o X-CommunityId da comunidade em que a operação acontece.
A equipe (owner, admin, moderador e financeiro, cada um só em post de espaço que abre; SuperAdmin) vê "87 de 120 confirmaram": `total` é quem tem acesso ao post hoje (as mesmas regras de acesso do espaço e do post, sem o autor), `confirmed` quem confirmou a versão atual, `pending` quem falta. As contagens são sempre do público inteiro; `status` filtra a lista (`confirmed`, `pending` ou `all`), em ordem de nome. Quem confirmou e depois perdeu o acesso não entra na conta. `nextReminderAt` diz quando o próximo lembrete pode sair. `lastReminderSendId` é o id do envio do último lembrete (nulo sem lembrete): com ele, `GET /api/notifications/sends/{sendId}` diz quem abriu e quem não abriu o lembrete. Membro: 403. Post que não pede confirmação: 409 `postAck.notRequired`.
Parâmetros
| Nome | Onde | Tipo | Descrição |
|---|---|---|---|
idobrigatório | path | string (uuid) | |
statusopcional | query | all | confirmed | pending | |
pageopcional | query | integer | |
limitopcional | query | integer |
Headers
| Nome | Tipo | Descrição |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Respostas
| Código | Descrição |
|---|---|
200 | As contagens e a página de pessoas. |
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. |
409 | O post não pede confirmação (`notRequired`). |
500 | Erro interno do servidor. |
Exemplo com curl
curl -X GET "https://api.memberfy.net/api/content/<id>/acknowledgements" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID"