Aller au contenu

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

StatutDescription
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`.

Exemple curl

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