加载中…
业务咨询 consultation

模块说明

consultation 提供业务咨询的入口信息与咨询提交接口(常见于首页浮动咨询表单)。提交为匿名接口,服务端做字段校验与 IP 级防灌水,灌水命中时返回 429。

鉴权级别:可选(匿名可提交)。

接口一览

方法 URL 鉴权 说明
GET /api/consultation 可选 咨询信息(标题)
POST /api/consultation/store 可选 提交咨询(限流 5 次/300 秒)

咨询信息

GET /api/consultation
{
  "code": "OK",
  "message": "",
  "data": { "title": "业务咨询" },
  "errors": {},
  "request_id": "9f2a5c8e1b3d7f40"
}

提交咨询

POST /api/consultation/store
Content-Type: application/json

{
  "…": "咨询字段(以站点后台咨询字段配置为准,常见:称呼、联系方式、需求描述等)"
}

成功响应

{ "code": "OK", "message": "咨询提交成功", "data": {}, "errors": {}, "request_id": "..." }

失败响应

场景 响应
字段校验失败 422 INVALID_PARAMS,errors 逐字段错误
防灌水命中 429 RATE_LIMITED,message 提示提交过于频繁

注意事项

  • 与留言板(guestbook)的区别:咨询是销售/服务线索型表单,灌水命中时本模块返回 429(留言板返回 422),客户端按此区分提示文案与重试逻辑;
  • 咨询字段由后台咨询模块配置决定;
  • 中间件限流同样是 5 次/300 秒。
添加日期:2026-10-06