微调解 · API v1

小程序接口说明

基础路径 /api。成功：{"success":true,"data":…}；失败：非2xx，{"success":false,"message":"原因"}。

用户接口使用 Authorization: Bearer <token>。正式服务使用 HTTPS，AppSecret 只在后台配置。API 不接受前端传入的 owner、openid 或权限字段。材料只允许所属用户和管理员下载。

方法	路径	说明
GET	/health	服务与数据库健康状态
GET	/content	已发布 activities、stories、topics
POST	/auth/wechat/login	{code} → registered / sessionTicket / token / user
POST	/auth/wechat/complete	{sessionTicket,phone,volunteerCode,squadCode,activationCode} → token、user
POST	/auth/logout	撤销当前用户令牌
GET	/me	本人资料、cases、clues、joins、favorites
GET / POST	/cases	本人咨询列表 / 提交咨询
GET	/cases/{id}	本人咨询详情与回复记录
POST	/cases/{id}/withdraw	撤回本人未完成咨询
POST	/cases/{id}/materials	{fileIds:[]} 补充本人咨询材料
GET / POST	/clues	本人线索列表 / 提交线索
POST / DELETE	/activities/{id}/join	真实名额报名 / 取消（事务控制并发）
POST / DELETE	/stories/{id}/favorite	收藏 / 取消收藏公开案例
POST	/files	multipart/form-data，file 字段，单份≤20MB，返回材料id
GET	/files/{id}/download	带用户令牌下载私有材料，后台使用管理员会话

提交咨询 / 线索

公共字段：title（1–40字）、region（省市区数组）、description（10–2000字）、name、phone（手填手机号）、fileIds（已上传材料id，最多10份）、requestId（8–80字，客户端为每次提交生成并在重试时复用）。

咨询另含 type（婚姻家庭、邻里纠纷、物业纠纷、劳动纠纷、债务纠纷、消费纠纷、其他纠纷）、demand（咨询问题）、otherParty（可选）。线索另含 topicId（可选征集主题id）。

重复 requestId 返回同一记录。服务端检查用户归属、临时会话过期、志愿者编号单账号绑定、主题与活动截止时间。用户手机号只做格式校验，不表示号码归属已经验证。

公司编码 DLA、团队编码 001、成员编码 A001，完整志愿者编号为 DLA-001-A001。成员编码由服务端在所属团队内按 A001、A002 顺序自动分配，编号不能由前端指定。团队编号为 DLA-001；不同公司可使用相同三位团队编码。

首次绑定需填写完整志愿者编号（volunteerCode）、完整团队编号（squadCode）与管理员单独发放的激活码（activationCode）。激活码只显示一次，使用后失效；完整编号不是登录密钥。

后台“服务配置”填写 AppID、AppSecret 与正式 HTTPS API 地址。在微信公众平台配置 request、uploadFile、downloadFile 合法域名；小程序 config/service.js 填写相同的 HTTPS API 地址。

IP:3124 仅用于开发联调。开发者工具可关闭域名校验，HTTP 访问仅在工具的 develop 环境启用；正式版必须使用 HTTPS 域名。