POST/api/public/consultation
Formulário público de pedido de aconselhamento do website Zentor.
A página «POST /api/public/consultation — Referência API» cobre a área funcional indicada pela URL. O conteúdo existente é ampliado com o fluxo real, requisitos e limites conhecidos. O Form Builder suporta formulários livremente configuráveis com palavras-chave de trigger, tipos de campo e indicação de campos obrigatórios. A função foi testada E2E. A documentação de `POST /api/public/consultation` deve ser lida como descrição técnica deste endpoint concreto. São determinantes método, caminho, autenticação, campos obrigatórios, erros possíveis e se uma nova chamada produz o mesmo efeito. A URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation deve conter apenas passos de integração rastreáveis e exemplos de resposta comprovados. Para chamar `/api/public/consultation`, o pedido é construído segundo a Registry. Rotas públicas não exigem Developer API Key geral. Rotas protegidas do widget utilizam o Embed Token mostrado uma vez e verificação de Origin. O estado HTTP e o conteúdo JSON devem ser avaliados em conjunto; um campo `ok` sozinho não substitui tratamento de erros. Nos testes de `POST /api/public/consultation` devem ser usados valores anonimizados. Dados reais de clientes, UUIDs produtivos, Session Tokens e timestamps concretos não pertencem a exemplos públicos. O limite conhecido da plataforma é 2.000 pedidos em 15 minutos; não existe limite individual diferente comprovado. Chamadas POST não idempotentes não devem ser repetidas cegamente após interrupção de rede ambígua. Erros típicos surgem por parâmetros obrigatórios em falta, tipos de dados errados, códigos de utilização única expirados, Origins não autorizadas ou um registo ainda inexistente. A aplicação deve tratar os casos separadamente e registar a mensagem devolvida sem incluir segredos. Um pedido bem-sucedido confirma apenas este passo, não automaticamente um sucesso posterior de e-mail, pagamento ou SSO. Isto é diretamente relevante para `POST /api/public/consultation`. A verificação técnica desta página deve basear-se na Registry em `app/frontend/src/content/api-reference/` e nas rotas backend correspondentes. Notas de teste live só podem afirmar o que foi realmente verificado. Um teste negativo ou analogia de código não é prova completa de sucesso.
Autenticação e segurança
Não é necessária autenticação
Idempotente: Não
Parâmetros
name(body, string, obrigatório)— 2–120 caracteresemail(body, string, obrigatório)— Endereço de e-mail válidocompany(body, string)message(body, string)phone(body, string)consentGiven(body, boolean, obrigatório)— Tem de ser truePedido de exemplo
{"name":"Max Mustermann","email":"max@example.com","company":"Empresa Exemplo","message":"Assunto","consentGiven":true}Resposta de exemplo
{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}Códigos de erro
400 VALIDATION_ERROR — Campo obrigatório em falta/inválido ou consentimento em falta.Evidência de teste live
Sucesso (200) e caso negativo (400) verificados live.