下载中心/接口清单

接口清单

下载原文件

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。