Saltar al contenido

Pede o código do passo extra

POST/api/auth/two-factor/step-up

Auth
Requiere token
Clave de API:
No acepta clave de API
X-CommunityId
X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

Para quem tem 2FA ligado, antes de desligar o 2FA, trocar o telefone dele, gerar novos códigos de recuperação, criar chave de API, pedir saque ou mudar a conta de recebimento. Manda o código ao telefone do 2FA (WhatsApp, ou SMS com `channel: sms`). Confirme em `/step-up/verify`.

Headers

NombreTipoDescripción
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Cuerpo de la solicitud application/json

NombreTipoDescripción
channelopcionalwhatsapp | sms

Respuestas

CódigoDescripción
200Código enviado.
401Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`).
409Conflito com o estado atual do recurso.
429Limite de códigos.

Ejemplo con curl

curl -X POST "https://api.memberfy.net/api/auth/two-factor/step-up" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{}'