通用数据集成 API 方案

用于 合作伙伴 从 Lenovo 查询数据的统一 API 方案，对接前请了解 API 接入流程

请求地址

环境	URL
测试	https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/scc/open_platform/data/query/{data_category}/{biz_key}
正式	https://api-cn.lenovo.com/v1.0/supply_chain/scc/open_platform/data/query/{data_category}/{biz_key}

公共请求参数

调用前，请先获取 Token

参数位置	参数名称	描述	备注
Http Method			POST
-	-	-	-
Header	Authorization	Bearer + 空格 + Token	Bearer aaf0d4d6-c541-34cd-a4e0-03da1cc4019d
-	-	-	-
Url Path	data_category	数据分类	参考具体数据接口 URL
Url Path	biz_key	业务关键字	参考具体数据接口 URL

公共请求参数

位置	名称	必填	类型	长度	描述
Body	appName		String	10	合作伙伴简称，非必须
Body	pageNo	Y	String	5	页码
Body	pageSize	Y	String	5	每页数据量
Body	criteria	N	Map		查询条件

公共响应参数

位置	名称	必填	类型	格式	描述	示例
Body	code	Y	String	---	状态码	"0"代表成功,其他失败可参考返回码
Body	msg	N	String	---	提示消息	非"0"时,会提示错误消息
Body	result	N	object/array	---	数据体

• 请求示例

  POST https://api-cn-t.lenovo.com/uat/v1.0/supply_chain/data/query/odm/DemoData

• Header Authorization = Bearer aaf0d4d6-c541-34cd-a4e0-03da1cc4019d

• Content-Type application/json

{
  "pageNo": 1,
  "pageSize": 10,
  "criteria": {
    "vendorCode": "0001000836",
    "lastModifiedDate": "2023-10-24 00:02:08"
  }
}

• 响应示例

{ "code":"0",
  "msg":"request success!",
  "result":
  {
    "total":15,
    "data":[
      {
        "lpart_category": "PRODUCT",
        "odm": "LCFC",
        ....
      },
      ....
    ]
  }
}

• 异常示例

{
  "code": "-1",
  "msg": "System error！",
  "result": null
}

通用错误码说明

参数位置	Value	描述
httpcode	200	正常返回结果
httpcode	401	Token 错误/签名错误
httpcode	404	访问的路径不存在
httpcode	500	服务器错误
body.code	"0"	成功
body.code	"-1"	系统错误