外部建单 / 查询联调

tenant_id 69861ff9cdf3989e558968fd upstream https://code.sofio.top:50010/api/external → 回主入口（BFF 零后端，推荐）

⚠️ HMAC 模式（接入方持 secret 自建后端）已无活接入方在用；接入方都走 BFF 零后端。此页保留供后端排错/老接入方对接备用

接入方

端点投诉口 /api/external/complaints（L3 锁死 21）通用口 /api/external/tickets（必传 L3）

必填

external_id（可选）留空 → 服务端自动生成 auto-<app_id>-<16hex> + 60s 内容指纹防抖（需 phone）。
传值则走精确幂等，建议带接入方前缀（顶部选择器决定）避免跨渠道撞车。 community（小区）

title（一句话诉求）联调阶段所有工单标题必须以「测试工单」开头

可选 description（最长 5000 字）

priority channel occurred_at

投诉人 / 报修人（可选）

name phone room

录入员（submitted_by，可选）

oa_user_id name

附件 URL（可选，每行一条） URL 仅记录不下载，需公网可达

external_metadata（可选，JSON）自定义透传字段，上游原样存储；格式必须是 JSON object

图片上传（可选，最多 10 张，每张 ≤ 10MB）仅支持 jpg / png / webp；选了文件会以 multipart 上传，签名对整段 multipart body 生效

响应