Inicia a recuperação de senha
POST/api/auth/recovery-password
- Auth
- Public
- 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.
Dispara o email de recuperação. Responde sucesso mesmo quando o email não existe, de propósito — não revela quais emails estão cadastrados. Procura a conta pelo par (`X-CommunityId`, e-mail); a senha temporária só abre esta comunidade. Exige `altcha` (desafio de `GET /api/auth/challenge` resolvido) em toda chamada, conferido antes de procurar a conta: 422 com `param = altcha` igual para e-mail com ou sem conta. Limite de 20 pedidos por IP em 15 minutos (429 com `Retry-After`).
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 |
|---|---|---|
emailobligatoire | string (email) | |
altchaobligatoire | string | O payload do widget ALTCHA (base64 de `{ challenge, solution }`) sobre um desafio de `GET /api/auth/challenge`. Uso único. · max 8192 |
Réponses
| Statut | Description |
|---|---|
200 | Solicitação registrada (resposta idêntica para email existente ou não). |
400 | Requisição inválida — falha de validação. |
422 | Verificação ALTCHA ausente, inválida, vencida, já usada ou (no login) mais fácil do que o e-mail exige agora (`errors[0].param = altcha`). Peça um desafio novo (no login, `POST /api/auth/challenge` com o e-mail), resolva e reenvie. |
429 | Tentativas demais. O header `Retry-After` diz em quantos segundos tentar de novo. |
503 | A API não consegue verificar o ALTCHA agora (chave não configurada em produção). `param = altcha`. |
Exemple curl
curl -X POST "https://api.memberfy.net/api/auth/recovery-password" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]","altcha":"eyJjaGFsbGVuZ2UiOnsicGFyYW1ldGVycyI6ey4uLn19LCJzb2x1dGlvbiI6ey4uLn19"}'