P26 接口清单
版本:V1.2 说明:统一前缀 /api/supplier,JSON 交互;鉴权沿用平台账号体系,平台侧接口需稽核/品质角色。
1 入驻与档案
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /profile/submit | 提交入驻资料(基础信息 + 工艺范围) |
| GET | /profile/detail | 供应商档案详情(含资质、星级、标签) |
| POST | /cert/upload | 上传资质证书(文件先走存储,再登记地址) |
| POST | /profile/review | 平台初审通过/驳回(附不符合项) |
关键字段:supplier_id、company_name、factory_address、supplier_level(L1/L2)、process_tags[]、certs[]、capacity。
2 稽核任务
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /audit/create | 新建稽核任务(online/site/annual/special) |
| GET | /audit/list | 稽核任务列表(按供应商、状态、类型筛选) |
| GET | /audit/detail | 稽核报告与 NC 明细 |
| POST | /audit/nc/add | 新增 NC(等级 major/minor/observation) |
| POST | /audit/fix/submit | 供应商提交整改方案与证据 |
| POST | /audit/fix/review | 平台复查,关闭或退回 |
状态机:待启动 → 稽核中 → 待整改 → 复查中 → 关闭。
3 评级与年审
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /star/calc | 按权重重算星级,写入历史快照 |
| GET | /star/history | 评级历史(前后星级、原因、关联稽核) |
| POST | /star/weight | 修改权重(品质/交期/服务/资质) |
| GET | /audit/remind | 年审与证书到期预警列表 |
| POST | /audit/annual | 发起年审,结果写回等级与状态 |
4 黑名单
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /blacklist/save | 拉黑或解除,必须填写原因与证据 |
| GET | /blacklist/list | 黑名单列表与历史操作 |
5 返回约定
- 统一
{ code, message, data },code=0表示成功。 - 名单类接口支持分页:
page、page_size(默认 20,上限 100)。 - 敏感操作写入审计日志:操作人、时间、变更前后值、IP。
- 供应商侧接口只返回自身数据,越权一律拒绝,不返回空壳 200。

