api.md 3.9 KB
摊位审核接口（034）
商家 App 前端字段、页面状态及调用顺序见 App 前端对接说明。
数值状态：0 草稿、1 待审核、2 通过、3 驳回；-1 仅表示未创建申请，不入库。
商家 PC：token 请求头，@Auth 校验
GET /stall/qualification：只允许有效 type=4 账号；storeId 从账号反推。返回storeId/stallName/stallAddress/nightMarketId/version/currentApplication/approvedApplication/history；history 只有 id/applicationVersion/status/submittedAt/reviewedAt/rejectReason。POST /stall/qualification/draft、POST /stall/qualification/submit：JSON{version,responsibleName,contactPhone,identityNumber,email?,stallIntroduction?,bankAccountName,bankName,bankAccountNo,identityImageUrls,stallImageUrls,bankProofImageUrls,businessRegistrationImageUrls?,directorScreenshotImageUrls?,uboDeclarationImageUrls?,foodRegistrationNumber?,foodRegistrationImageUrls?}。不接收 storeId 或审核字段。图片数组传商品上传返回的/profile/upload/...路径，兼容本摊位旧私有附件引用。公共路径必须是系统实际存在的 JPEG/PNG（最多5MB、2000万像素），拒绝外部 URL/路径穿越/伪图片。草稿允许不完整；提交时负责人、证件、摊位照片和银行四项必填。电子邮箱填写时校验格式。GET /stall/qualification/applications/{id}：仅本摊位可查看历史材料。GET /stall/qualification/market：仅有效 type=3 夜市主；返回己方摊位的storeId/status/approved，不返回姓名、证件号、电话和附件。- 新图片：复用商品
POST /utils/Upload，multipart 的file；返回{code:200,data:"/profile/upload/YYYY/MM/DD/文件名.png"}，后端会把文件名中/ \ : * ? " < > | ; # % ,及控制字符规范为_。商家前端用商品同款el-upload直传并按VUE_APP_BASE_URL + data展示，平台直接用共享ImagePreview解析路径。无需额外调用审核文件接口，图片 GET 无需登录，用户已确认包括证件在内的链接公开访问。 POST /stall/qualification/files：保留兼容，multipart file 返回旧私有引用storeId/uuid.jpg或.png；新版 PC 不再调用。GET /stall/qualification/files/{storeId}/{fileName}：仅兼容历史私有附件，只能查看本人摊位文件，返回图片二进制且 Cache-Control=no-store。
平台 PC：现有 Authorization 登录机制和权限
GET /system/stallQualification：list 权限，显式 pageNum/pageSize/status/storeId；仅列出待审核、已通过、已驳回（status=1/2/3），清空筛选也不返回草稿，显式请求 status=0 拒绝。只返回申请摘要，不返回身份材料。GET /system/stallQualification/applications/{id}：query 权限，完整已提交申请材料及审核信息；草稿不可由平台查看。POST /system/stallQualification/applications/{id}/review：review 权限，JSON{version,approved,rejectReason}，approved 必须明确，驳回原因最长500字且必填。审核通过时复核银行等必填材料；旧待审核申请缺银行资料须驳回补齐重提。操作人来自平台登录，待审核记录只可处理一次。GET /system/stallQualification/files/{storeId}/{fileName}：仅兼容历史私有附件，query 权限，图片二进制且 Cache-Control=no-store；新公共路径直接使用商品图片预览，不请求此接口。
写入/审核失败使用项目国际化业务错误；不记录包含材料的请求/响应业务日志。JSON/绑定参数错误仅返回通用本地化参数错误，不把原始证件值、附件引用或解析异常交给全局日志。材料 Mapper WARN、Druid 材料 SQL 参数在慢日志及监控缓存中脱敏。 分页列表默认10、最多100条。主表/申请 version 不匹配时返回冲突业务错误，前端提示重新加载，不自动重试覆盖他人资料。