Aller au contenu

Define a senha pelo link do convite

POST/api/auth/set-password

Auth
Public
Clé d’API:
Clé d’API non acceptée
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.

Sem login: o link de uso único do e-mail de convite (`https://<app da comunidade>/_/auth/set-password?id=<id>&token=<token>`) é a credencial. Vale 7 dias e uma vez. A senha segue a regra do cadastro (mínimo de 8 caracteres, com letra maiúscula, letra minúscula e número). `id` inexistente ou `token` errado: 400 com `param = token`. Link já usado ou vencido: 410 com `param = token`. Limite de 10 requisições por IP a cada 15 minutos (429). Não abre sessão: depois, a pessoa entra com `POST /api/auth/login`, e `data.email` serve para preencher o campo. O link é da conta de uma comunidade (o perfil convidado); definir a senha muda só essa conta e encerra as sessões abertas antes dela. Link antigo (sem perfil): 400.

Corps de la requête application/json

NomTypeDescription
idobligatoirestring (uuid)
tokenobligatoirestring
passwordobligatoirestring (password)min 8
acceptedTermsfacultatifbooleanAceite dos Termos de uso. Opcional: definir a senha do convite registra o aceite na conta, se ainda não houver um. Enviado, precisa ser `true`; `false` devolve 400 com param = acceptedTerms.
ageConfirmedfacultatifbooleanConfirma a idade mínima da comunidade (16 ou a `minimumAge`). Obrigatório quando a conta ainda não confirmou essa idade (o cadastro com aprovação já confirmou no pedido): sem o campo ou com `false`, a resposta é 400 `param = ageConfirmed` com `data.minimumAge`. Com `false` é 400 sempre.

Réponses

StatutDescription
200Senha definida (`data.email`).
400Requisição inválida — falha de validação.
410Link já usado ou vencido.
429Requisições demais deste IP.
500Erro interno do servidor.

Exemple curl

curl -X POST "https://api.memberfy.net/api/auth/set-password" \
  -H "Content-Type: application/json" \
  -d '{"id":"c9c35f8c-7757-4d6b-bd3a-e6ffb6385e66","token":"a3f9c2e1b7d84f6a9e0c1b2d3e4f5a6b","password":"Senha@123"}'