POST/api/public/access-request/email/verify

Verifica o código enviado por e-mail e emite um token de confirmação para o pedido de acesso subsequente.

Envie o `verification_id` (de `start-verification`), o mesmo `email` e o `code` de seis dígitos. Em caso de sucesso, a resposta contém `verified: true` e um `verification_token` que envia ao submeter o pedido de acesso via `POST /api/public/access-request`. Um código incorreto ou expirado, um `verification_id` não correspondente ou um endereço de e-mail diferente resultam em 400 `VERIFY_FAILED`. Nesse caso, peça um novo código. O token só é válido para esse endereço de e-mail e não deve aparecer em URLs ou registos. No máximo 10 pedidos por 15 minutos por endereço IP.

Visão geral

Chamada: POST /api/public/access-request/email/verify. Este endpoint pertence ao grupo «Formulários públicos» da API da Zentor App. É de acesso público e não requer autenticação. A chamada não é idempotente: cada chamada bem-sucedida volta a desencadear a ação. Parâmetros obrigatórios: verification_id (body), email (body), code (body). Casos de erro documentados: 400 VERIFY_FAILED. A resposta de exemplo abaixo mostra a estrutura de uma resposta bem-sucedida em formato JSON.

Autenticação e segurança

Não é necessária autenticação

Idempotente: Não

Parâmetros

verification_id(body, string, obrigatório)— `verification_id` de `start-verification`
email(body, string, obrigatório)— O mesmo endereço de e-mail usado ao pedir o código
code(body, string, obrigatório)— Código de seis dígitos do e-mail

Pedido de exemplo

{"verification_id":"<UUID>","email":"max@example.com","code":"123456"}

Resposta de exemplo

{"ok":true,"verified":true,"verification_token":"<Token para o pedido de acesso seguinte>"}

Códigos de erro

400 VERIFY_FAILED — O código, o `verification_id` ou o endereço de e-mail estão incorretos, ou o código expirou.

Comportamento verificado

Um código incorreto devolve 400 `VERIFY_FAILED`. O caso de sucesso corresponde à confirmação por e-mail do configurador de produto.

Formulários públicos

POST /api/public/contactRecebe um pedido do formulário de contacto do website da Zentor App e reencaminha-o para a equipa Zentor.POST /api/public/consultationRecebe um pedido de consultoria do formulário do website da Zentor App.POST /api/public/access-requestSubmete um pedido de acesso para um pacote (Starter, Individual ou demo de 14 dias). É necessário um endereço de e-mail previamente confirmado.POST /api/public/access-request/email/start-verificationEnvia um código de confirmação de seis dígitos, válido por 10 minutos, para o endereço de e-mail indicado — o primeiro passo de um pedido de acesso.GET /api/public/access-request/payment-statusIndica que métodos de pagamento (PayPal, Stripe) estão atualmente disponíveis para o pedido de acesso.GET /api/public/access-request/paypal/configDevolve a configuração pública do PayPal (ativo, modo, moeda) para o passo de pagamento.POST /api/public/access-request/paypal/create-orderCria uma encomenda PayPal para o pacote selecionado.POST /api/public/access-request/paypal/capture-orderConclui (captura) uma encomenda previamente criada e aprovada pelo comprador no checkout do PayPal. O valor é definido exclusivamente pelo servidor.POST /api/public/access-request/stripe/create-checkoutCria uma sessão de checkout Stripe para o pacote selecionado.POST /api/public/activate-accountAtiva uma conta de utilizador recém-criada e define a primeira palavra-passe — ativado através do link no e-mail de convite.

Artigos relacionados

← Formulários públicos