Desafio ALTCHA para entrar, cadastrar ou recuperar a senha
GET/api/auth/challenge
- Auth
- Public
- API key:
- No API key accepted
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.
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.
Responses
| Status | 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`. |
curl example
curl -X GET "https://api.memberfy.net/api/auth/challenge"