Saltar para o conteúdo

Enviar o formulário (membro, no app)

POST/api/forms/{id}/submissions

Auth
Exige token
Chave de API:
Não aceita chave de API
X-CommunityId
X-CommunityId Envie o X-CommunityId da comunidade em que a operação acontece.

Qualquer papel com acesso ao espaço; sem ALTCHA. O envio fica ligado ao membro. No máximo 10 envios aceitos por pessoa e formulário por hora (os recusados não contam) e 60 tentativas de qualquer resultado (429). Encerrado (à mão, por prazo ou por limite, conferido na mesma transação): 422 `formClosed`. Campo inválido ou obrigatório vazio: 422 com `errors[].param` = `answers.<fieldId>`.

Parâmetros

NomeOndeTipoDescrição
idobrigatóriopathstring (uuid)

Headers

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

Corpo da requisição application/json

NomeTipoDescrição
answersobrigatórioobject[]
answers[].fieldIdopcionalstring (uuid)
answers[].valueopcionalobject

Respostas

CódigoDescrição
201Enviado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
422Encerrado ou respostas inválidas.
429Envios demais desta pessoa neste formulário.

Exemplo com curl

curl -X POST "https://api.memberfy.net/api/forms/<id>/submissions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"answers":[{}]}'