POST/api/public/consultation

Zentor 网站公共咨询申请表。

"POST /api/public/consultation — API 参考"页面涵盖 URL 所指的功能区域。现有内容已补充实际流程、前置条件及已知限制。表单构建器支持配置带有触发关键词、字段类型和必填标识的自由表单。该功能已完成端到端(E2E)测试。 关于 `POST /api/public/consultation` 的文档应作为该具体端点的技术说明来阅读。关键在于方法、路径、认证、必填字段、可能错误以及重复调用是否产生相同效果。因此,URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation 不得包含笼统的宣传语,而应仅提供可复核的集成步骤及经证实的响应示例。 调用 `/api/public/consultation` 时,请求需依据注册表构建。公共路由无需通用开发者 API 密钥,因为 Zentor 不提供此类密钥系统。受保护的小部件路由则使用一次性显示的嵌入令牌(Embed-Token)及来源验证。HTTP 状态与 JSON 内容必须共同评估;仅凭 `ok` 字段不能替代错误处理。 测试 `POST /api/public/consultation` 时须使用脱敏值。真实客户数据、生产环境 UUID、会话令牌及具体时间戳不得出现在公开示例中。已知的平台级限值为 15 分钟内 2,000 次请求;没有证据表明存在不同的单独限额。非幂等 POST 请求在不明网络中断后不得盲目重试。 该路由的典型集成错误源于缺少必填参数、数据类型错误、一次性代码过期、来源不被允许或数据记录未预先存在。应用应分别处理此类情况,记录端点返回的错误信息,但不得记录敏感内容。成功的请求仅确认此处理步骤,并不自动意味着邮件、支付或单点登录(SSO)已成功完成。这对"POST /api/public/consultation"尤为关键。 本页面的技术审查应严格依据注册表中的 `app/frontend/src/content/api-reference/` 及相关后端路由。实时测试记录仅能陈述实际验证的内容。失败场景测试或代码类比都不能构成完整的成功证明。因此,对于"POST /api/public/consultation — API 参考",必须明确区分文档结构、自动化测试与经安全观察到的实时行为。

身份验证与安全

无需身份验证

幂等: 否

参数

name(body, string,必填)— 2–120 个字符
email(body, string,必填)— 有效的电子邮件地址
company(body, string)
message(body, string)
phone(body, string)
consentGiven(body, boolean,必填)— 必须为 true

请求示例

{"name":"Max Mustermann","email":"max@example.com","company":"示例公司","message":"咨询事项","consentGiven":true}

响应示例

{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}

错误代码

400 VALIDATION_ERROR — 必填字段缺失/无效或缺少同意。

实时测试证明

成功(200)和失败场景(400)已实时验证。

← 公共表单