Responde a pesquisa (membro logado)
POST/api/surveys/{id}/responses
- Auth
- Jeton requis
- Clé d’API:
- Clé d’API non acceptée
- X-CommunityId
X-CommunityIdEnvoyez le X-CommunityId de la communauté où l’opération a lieu.
Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.
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.
Paramètres
| Nom | Emplacement | Type | Description |
|---|---|---|---|
idobligatoire | path | string (uuid) |
En-têtes
| Nom | Type | Description |
|---|---|---|
X-CommunityIdfacultatif | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Corps de la requête application/json
| Nom | Type | Description |
|---|---|---|
answersobligatoire | object[] | |
answers[].questionIdobligatoire | string (uuid) | |
answers[].optionValuesfacultatif | string[] | |
answers[].numberfacultatif | integer | |
answers[].textfacultatif | string | max 5000 |
Réponses
| Statut | 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. |
Exemple curl
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":[{}]}'