固镇县热线 Agent 接口文档

统一前缀 /api，请求需携带 x-api-key。

通用规则

鉴权请求头：x-api-key: <API_KEY>
请求体类型：Content-Type: application/json
统一响应结构：success、message、data
POST 成功：201 Created；GET 成功：200 OK
错误码：鉴权失败 401，方法不允许 405，无效 JSON 或空请求体 400

咨询待跟进followUpItems

GET /api/followUpItems：获取列表

POST /api/followUpItems：新增记录

POST 参数

字段	类型	说明
`callerName`	string	来电人
`contactInfo`	string	联系方式
`appealSource`	string	诉求来源
`appealCategory`	string	咨询/事项类别
`involvedUnit`	string	涉及单位/社区
`appealDescription`	string	诉求/咨询说明

热线工单hotlineTickets

GET /api/hotlineTickets：获取列表

POST /api/hotlineTickets：新增记录

POST 参数

字段	类型	说明
`callerName`	string	来电人
`contactPhone`	string	联系方式
`appealType`	string	诉求类型
`appealSubject`	string	诉求事项
`incidentAddress`	string	事发/涉及地址
`urgencyLevel`	string	紧急程度
`expectedDeadline`	string	期望办结时间
`assignedDept`	string	建议承办部门
`remark`	string	备注

内部消息通知cloudhubMessages

GET /api/cloudhubMessages：获取列表

POST /api/cloudhubMessages：新增记录

POST 参数

字段	类型	说明
`title`	string	消息标题
`content`	string	消息内容

邮件通知emails

GET /api/emails：获取列表

POST /api/emails：新增记录

POST 参数

字段	类型	说明
`title`	string	消息标题
`content`	string	消息内容