Desafio ALTCHA para entrar, cadastrar ou recuperar a senha
GET/api/auth/challenge
- 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. Devolve um desafio de prova de trabalho [ALTCHA](https://altcha.org) (protocolo v2, `PBKDF2/SHA-256`), assinado pela API, válido por 5 minutos e de uso único. O widget `altcha` resolve no navegador (cerca de 1 s num celular médio, sem chamada a terceiros) e entrega o payload que vai no campo `altcha` de `POST /api/auth/login`, `POST /api/auth/register` e `POST /api/auth/recovery-password`: os três exigem um desafio resolvido em **toda** chamada. Cada envio gasta o seu (peça outro para tentar de novo). Limite de 300 desafios por IP em 15 minutos (429). Integração de servidor não usa login: use uma chave de API.
Réponses
| Statut | Description |
|---|---|
200 | O desafio, no formato que o widget `altcha` aceita (`parameters` e `signature`). |
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 GET "https://api.memberfy.net/api/auth/challenge"