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 carateres
email(body, string, obrigatório)— Endereço de e-mail válido
message(body, string, obrigatório)— Mensagem, 10–3000 carateres
company(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.

Artigos relacionados

← Formulários públicos