模块说明
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 秒。