POST/api/public/access-request
Submete um pedido de acesso para um pacote (Starter, Individual ou demo de 14 dias). É necessário um endereço de e-mail previamente confirmado.
Confirme primeiro o endereço de e-mail através de `POST /api/public/access-request/email/start-verification` e `POST /api/public/access-request/email/verify`. Em seguida, envie `name`, o mesmo `email`, o pacote `package` (`starter`, `individual` ou `demo_access`) e o `verification_token` recebido. Opcionalmente podem ser enviados `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` ou `stripe_sepa`), `wish` (`trial`, `subscription` ou `offer`; sempre `trial` no acesso de demo) e `message`. Sem uma confirmação válida, o servidor responde 400 `EMAIL_NOT_VERIFIED`. A falta de campos obrigatórios ou valores inválidos para o pacote, método de pagamento ou pedido resultam em 400 `VALIDATION_ERROR`. Cada pedido bem-sucedido é criado como um novo pedido e processado pela Zentor; por isso não repita a chamada automaticamente. 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.
Visão geral
Chamada: POST /api/public/access-request. 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: name (body), email (body), package (body). Parâmetros opcionais: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Casos de erro documentados: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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
name(body, string, obrigatório)— Nome, 2–120 carateresemail(body, string, obrigatório)— Endereço de e-mail previamente confirmado através de `/email/verify`package(body, string, obrigatório)— Pacote: `starter`, `individual` ou `demo_access`company(body, string)— Empresa, máx. 160 carateres (opcional)phone(body, string)— Número de telefone, máx. 40 carateres (opcional)companyWebsite(body, string)— Website da empresa, máx. 200 carateres (opcional)paymentMethod(body, string)— Método de pagamento: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` ou `stripe_sepa` (opcional)wish(body, string)— Pedido: `trial`, `subscription` ou `offer`; sempre `trial` em `demo_access` (opcional)message(body, string)— Mensagem, máx. 3000 carateres (opcional)Pedido de exemplo
{"name":"João Silva","email":"max@example.com","package":"demo_access"}Resposta de exemplo
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}Códigos de erro
400 VALIDATION_ERROR — Falta um campo obrigatório, ou o pacote, o método de pagamento ou o pedido são inválidos.400 EMAIL_NOT_VERIFIED — O endereço de e-mail não foi confirmado previamente através de `/email/start-verification` e `/email/verify`, ou o `verification_token` está em falta ou é inválido.Comportamento verificado
Um corpo vazio devolve 400 `VALIDATION_ERROR`; dados válidos sem endereço de e-mail confirmado devolvem 400 `EMAIL_NOT_VERIFIED`. O caso de sucesso segue o fluxo documentado após a confirmação do e-mail.
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-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.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.