POST/api/public/contact
Recebe um pedido do formulário de contacto do website da Zentor App e reencaminha-o para a equipa Zentor.
Os campos obrigatórios são `name` (2–120 carateres), `email` (endereço de e-mail válido), `message` (10–3000 carateres) e `consentGiven`, que tem de ser definido como `true`. Opcionalmente, podem ser enviados `company`, `phone` e `topic`. Em caso de sucesso, o servidor responde com `{"ok":true}` e uma mensagem de confirmação. Se faltar um campo obrigatório, for inválido ou faltar o consentimento, o endpoint responde 400 `VALIDATION_ERROR`; o campo `details` lista os erros individuais, para que possa assinalar os campos afetados. Cada envio bem-sucedido cria um novo pedido. Por isso, desative o botão de envio até receber a resposta e 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/contact. 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), message (body), consentGiven (body). Parâmetros opcionais: company (body), phone (body), topic (body). Casos de erro documentados: 400 VALIDATION_ERROR. 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 válidomessage(body, string, obrigatório)— Mensagem, 10–3000 caraterescompany(body, string)— Empresa (opcional)phone(body, string)— Número de telefone (opcional)topic(body, string)— Assunto do pedido (opcional)consentGiven(body, boolean, obrigatório)— Consentimento de proteção de dados, deve ser `true`Pedido de exemplo
{"name":"Max Mustermann","email":"max@example.com","message":"A sua mensagem (mín. 10 caracteres).","consentGiven":true}Resposta de exemplo
{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}Códigos de erro
400 VALIDATION_ERROR — Falta um campo obrigatório ou é inválido, ou falta o consentimento de proteção de dados. `details` contém as mensagens de erro individuais.Comportamento verificado
Dados completos devolvem 200; campos obrigatórios em falta ou consentimento em falta devolvem 400 `VALIDATION_ERROR`.
Formulários públicos
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.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.