Responde a pesquisa (membro logado)
POST/api/surveys/{id}/responses
- Auth
- Requires a token
- API key:
- No API key accepted
- X-CommunityId
X-CommunityIdSend the X-CommunityId of the community the operation happens in.
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.
Qualquer papel da comunidade. Vale para quem está no público congelado ou, com o link público ligado, para qualquer membro (fora disso, 403). Uma resposta por pessoa (409 na segunda). Obrigatória sem resposta, opção que não é da pergunta ou valor fora da escala: 422 com `errors`. Encerrada ou antes de `startsAt` (agendada): 422. Na anônima, a resposta não guarda pessoa nem horário. Esta rota não aparece em log de acesso, Sentry, log da comunidade nem analytics, e não aceita chave de API.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
idrequired | path | string (uuid) |
Headers
| Name | Type | Description |
|---|---|---|
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 | Type | Description |
|---|---|---|
answersrequired | object[] | |
answers[].questionIdrequired | string (uuid) | |
answers[].optionValuesoptional | string[] | |
answers[].numberoptional | integer | |
answers[].textoptional | string | max 5000 |
Responses
| Status | Description |
|---|---|
201 | Resposta gravada. `data.respondAs` = `member`. |
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 | Esta pesquisa não é para você. |
404 | Recurso não encontrado. |
409 | Conflito com o estado atual do recurso. |
422 | Respostas inválidas, pesquisa encerrada ou ainda não começou (`notYetOpen`). |
500 | Erro interno do servidor. |
curl example
curl -X POST "https://api.memberfy.net/api/surveys/<id>/responses" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"answers":[{}]}'