BFF 零后端联调(v2.0)
BFF
https://code.sofio.top:50010/api/h5
auth
JWT (Authorization: Bearer ...)
→ HMAC 备用调试
业主绑定(bind_owner)
app_id
易软(物业 H5 / 产投 H5 网关)(easysoft-prod)
福流享家小程序(fuliuxiangjia-prod)
物业公众号(property-gzh-prod)
产投服务号(chantou-fwh-prod)
phone(联调业主可下拉选)
wxid
bind_owner
refresh_token
清除 token
建单
我的工单
端点
投诉口
/submit_complaint
(L3 锁 21,priority 默认 重要)
通用口
/submit_ticket
(必传 L3)
字段
title
description
category_l3
1 - 建议与反馈
2 - 表扬工单
3 - 问题咨询
4 - 系统处理
5 - 配送服务
6 - 个性服务
7 - 增值服务
8 - 治安安全
9 - 消防安全
10 - 车辆管理
11 - 噪音扰民
12 - 卫生问题
13 - 绿化问题
14 - 水电气维修-户内
15 - 门窗维修-户内
16 - 家具家电维修
17 - 户内其他维修
18 - 电梯故障
19 - 水电维修-公区
20 - 设施设备维修
公区位置补充
仅公区类工单建议填;提交时会附到 description 头部。户内类工单(户内维修等)无需填写,使用绑定房号即可。
external_id(可选,留空 = 自动生成)
priority
(投诉口默认 重要 / 通用口默认 一般)
一般
重要
紧急
channel
图片(可选,最多 10 张)
jpg / png / webp,单张 ≤ 10MB。提交时会先上传图片拿 msg_id,再带到建单请求里。
高级:手填 images URL(已上传的 msg_id 路径或公网图 URL,每行一条)
external_metadata(可选 JSON)
提交
填充示例
响应
HTTP
再发一次(测幂等)
原始响应
列表查询(phone 自动从 JWT 取,不用传)
status
(不限)
待派单
处理中
已完成
已评价
已关闭
已取消
page
page_size
since
until
查询
按 ticket_id 查
响应
HTTP
原始响应