Responde a pesquisa (membro logado)
POST/api/surveys/{id}/responses
- Auth
- Requiere token
- Clave de API:
- No acepta clave de API
- X-CommunityId
X-CommunityIdEnví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.
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.
Parámetros
| Nombre | Dónde | Tipo | Descripción |
|---|---|---|---|
idobligatorio | path | string (uuid) |
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Cuerpo de la solicitud application/json
| Nombre | Tipo | Descripción |
|---|---|---|
answersobligatorio | object[] | |
answers[].questionIdobligatorio | string (uuid) | |
answers[].optionValuesopcional | string[] | |
answers[].numberopcional | integer | |
answers[].textopcional | string | max 5000 |
Respuestas
| Código | Descripción |
|---|---|
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. |
Ejemplo con 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":[{}]}'