Saltar al contenido

Grava os valores dos campos customizados de um membro

PUT/api/profiles/{profileId}/fields

Auth
Requiere token
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.

Owner, admin e moderador gravam os de qualquer membro da comunidade do `X-CommunityId`; qualquer pessoa grava os próprios; o financeiro só lê os dos outros (403). `values` é um objeto `{ key: valor }` com as `key` de `GET /api/member-fields`; só os campos enviados mudam. `null` ou `""` limpa o valor; campo obrigatório não pode ser limpo (400 com o erro no campo). Valores por tipo: `TEXT` texto até 1000 caracteres; `NUMBER` número (aceita vírgula decimal); `DATE` `AAAA-MM-DD`; `BOOLEAN` `true`/`false`; `SELECT` o `value` (ou o rótulo) de uma opção. Erros voltam juntos, um por campo, e nada é gravado. A resposta traz `fields` (todos os campos ativos com o valor desta pessoa, `null` quando vazio) e `missingRequiredFields` (os obrigatórios ainda vazios).

Parámetros

NombreDóndeTipoDescripción
profileIdobligatoriopathstring (uuid)

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.

Cuerpo de la solicitud application/json

NombreTipoDescripción
valuesobligatorioobject

Respuestas

CódigoDescripción
200Valores gravados.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
500Erro interno do servidor.

Ejemplo con curl

curl -X PUT "https://api.memberfy.net/api/profiles/<profileId>/fields" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"values":{}}'