Saltar para o conteúdo

Desafio ALTCHA para entrar, cadastrar ou recuperar a senha

GET/api/auth/challenge

Auth
Pública
Chave de API:
Não aceita chave de API

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.

Respostas

CódigoDescrição
200O desafio, no formato que o widget `altcha` aceita (`parameters` e `signature`).
429Tentativas demais. O header `Retry-After` diz em quantos segundos tentar de novo.
503A API não consegue verificar o ALTCHA agora (chave não configurada em produção). `param = altcha`.

Exemplo com curl

curl -X GET "https://api.memberfy.net/api/auth/challenge"