[系统运维]仓储-省级开放数据接口清单

仓储-省级开放数据接口清单

1、版本历史

2、通用原则

HTTP Method和对应的操作

### HTTP Method和对应的操作

| HTTP Method | 对应操作                         |
| ----------- | ---------------------------- |
| GET         | 请求单个资源或请求一个资源集合              |
| POST        | 创建新资源；也可以用来执行复杂条件和结构的资源查询    |
| PUT         | 更新已存在资源的属性；也可以用来调用已存在资源的某些操作 |
| DELETE      | 删除一个已存在的资源                   |

全局响应状态码说明

请求参数说明

• 分页，起始页 从1开始
• 分页，每页的条数不得超过30条；

返回结果

所有返回结果以 JSON 格式返回；接口返回一共有三种情况：

1. 操作成功后返回，范例：

   {
     "code": "200",//状态码
     "msg": "SUCCESS"//信息
   } 
   

2. 成功返回数据，范例：

   {
     "data": {//数据
       "name": "名称",
       "age": "18"
     },
     "code": "200",//状态码
     "msg": "SUCCESS"//信息
   }
   

3. 错误返回，范例：

   {
     "code": "1001",//错误状态码
     "msg": "参数不合法"//错误信息
   }
   

接口认证

header 中增加 access_token头信息数据
或者url中携带access_token请求参数

常量信息表

• 仓库信息表

• 装备备件状态信息表

• 入库类型信息表

• 出库类型信息表

3、接口清单

3.1、生成条码

请求说明

请求方式：GET

请求URL ：/equipment/registerSystemApi/generateQrCodes.do

请求参数

返回示例说明

{
  code:"200",
  msg:'success',
  data:["条码1","条码1",...]
}

3.2、登记系统备件台账信息同步至天元

请求说明

请求方式：POST

请求URL ：/equipment/registerSystemApi/saveOrUpDateMateriel.do

请求参数

返回示例说明

{
  code:"200",
  msg:'success'
}

3.3、登记系统调拨信息同步至天元

请求说明

请求方式：POST

请求URL ：/equipment/registerSystemApi/saveTransfersInfos.do

请求参数

返回示例说明

{
  code:"200",
  msg:'success'
}

3.4、天元入库信息同步至登记系统

请求说明

请求方式：POST

请求URL ：登记系统提供

请求参数

3.5、天元调拨信息同步至登记系统

请求说明

请求方式：POST

请求URL ：登记系统提供

请求参数

创作打卡挑战赛

赢取流量/现金/CSDN周边激励大奖