Saltar al contenido

Quem confirmou e quem não confirmou a leitura de um post

GET/api/content/{id}/acknowledgements

Auth
Requiere token
Clave de API:
content:read
X-CommunityId
X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

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

NombreDóndeTipoDescripción
idobligatoriopathstring (uuid)
statusopcionalqueryall | confirmed | pending
pageopcionalqueryinteger
limitopcionalqueryinteger

Headers

NombreTipoDescripción
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respuestas

CódigoDescripción
200As contagens e a página de pessoas.
401Token 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`).
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
409O post não pede confirmação (`notRequired`).
500Erro interno do servidor.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/content/<id>/acknowledgements" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"