POST/api/public/access-request/email/start-verification

Envia 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.

Envie o endereço a confirmar no campo `email`. A resposta contém `verification_id`, `expires_in_minutes` (10) e `resend_cooldown_seconds` (60). Use o `verification_id` junto com o mesmo endereço de e-mail e o código recebido em `POST /api/public/access-request/email/verify`. Um novo código só pode ser enviado depois de terminado o tempo de espera; mostre o tempo restante na sua interface. Se o limite for excedido, o endpoint responde 429 `RATE_LIMIT_EXCEEDED`. Se o e-mail não puder ser entregue, responde 502 `MAIL_NOT_SENT`; nesse caso, verifique o endereço e tente novamente mais tarde.

Visão geral

Chamada: POST /api/public/access-request/email/start-verification. 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: email (body). Casos de erro documentados: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. 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

No máximo 10 pedidos por 15 minutos por endereço IP. Aplicam-se ainda as regras de acesso da Zentor (regras de IP, país e domínio de e-mail); os pedidos rejeitados recebem 403.

Limite de pedidos: 10 Anfragen pro 15 Minuten (IP-basiert)

Idempotente: Não

Parâmetros

email(body, string, obrigatório)— Endereço de e-mail a confirmar

Pedido de exemplo

{"email":"max@example.com"}

Resposta de exemplo

{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}

Códigos de erro

429 RATE_LIMIT_EXCEEDED — Demasiados pedidos a partir deste endereço IP. Aguarde antes de pedir um novo código.
502 MAIL_NOT_SENT — O código de confirmação não pôde ser entregue por e-mail.

Comportamento verificado

A chamada devolve 200 com um `verification_id`, e o código é entregue por e-mail; chamadas repetidas devolvem 429 `RATE_LIMIT_EXCEEDED`.

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/verifyVerifica o código enviado por e-mail e emite um token de confirmação para o pedido de acesso subsequente.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