你当前的位置:帮助中心 > 卖家帮助 > 大卖场API接口对接指南

大卖场API接口对接指南


一、对接步骤

image.png

对接过程中遇到问题,请联系您的专属客服


二、接口介绍

2.1 获取Access Token
    2.1.1 接口描述

    接口描述:调用该接口,获取token授权,token将作为其他接口的授权凭证。

    注意事项:获取access_token需要本地保存。有效时长,access_token为24H 。

    URL: http://itpgd.zgw.com/api/Token/GetToken


  2.1.2 参数格式

     访问方式:"Content-Type", "application/x-www-form-urlencoded"

     HTTP请求方式:Get


2.1.3 请求参数


 参数名称

类型

必填

描述 

appId

String

中钢网提供的appId   (请联系专属客服获取)

appSecret

String

中钢网提供的appSecret    (请联系专属客服获取)

 

2.1.4 请求示例

      http://itpgd.zgw.com/api/Token/GetToken?AppId=xxxxxx &appSecret=xxxxxx


2.1.5 响应参数

 参数名称

类型

必填

描述 

result

Int

1成功, 0 失败

msg

String

提示内容

access_token

String

调用凭据

expires_in

int 

有效时长 单位为秒

  

响应示例

获取token成功的示例:

{

  "result": 1,

  "msg": "获取token成功",

  "access_token": "3B80E7C1BD021F9AE50171ABF356D0E8",

  "expires_in": 86400

}

 

获取token失败的示例

{

 "result": 0,

  "msg": "失败原因",

  "access_token": "",

  "expires_in": 0

}


2.2 验证token是否有效
2.2.1接口描述

调用该接口,验证token 是否有效

URL:http://itpgd.zgw.com/Api/Token/CheckToken


2.2.2参数格式

    访问方式:"Content-Type", "application/x-www-form-urlencoded"

    HTTP请求方式:Get


2.2.3 请求参数

 参数名称

类型

必填

描述 

access_token

String

access_token

 

2.2.4 请求示例

    http://itpgd.zgw.com/api/Token/CheckToken?access_token=xxxxxx

 

2.1.5 响应参数


 参数名称

类型

必填

描述 

result

Int

1成功, 小于1 失败

msg

String

错误信息

 

  响应示例

获取token成功的示例:

{

  "result": 1,

  "msg": "Token有效"


获取token失败的示例

{

  "result": -9,

  "msg": "当前access_token无效"

}

 


2.3 上传现货产品





 2.3.1 接口描述

   调用该接口,上传现货产品。

   URL:http://itpgd.zgw.com/api/Product/UploadProductData


2.3.2参数格式

    访问方式:"Content-Type", "application/x-www-form-urlencoded"

    HTTP请求方式:POST


2.3.3 请求参数


 参数名称

类型

必填

描述 

AppID

String

由中钢网提供

Access_Token

String

调用凭据,由1.1接口返回值access_token

EpID

String

由中钢网提供企业 id(请联系专属客服获取)

IP

String

请求IP不可为空 格式如117.160.131.19

IsFull

String

0是增量 既追加产品,1是全量,既先删除所有产品,再上传 

Products

数组

产品数据json数组(结构说明如下表)。

 

   Products结构说明

参数名称

类型

必填

描述 

Number

Int

数据序号,从1开始。

Pm

String

产品品种名称,如螺纹钢。

Cz

String

产品材质 ,不能为空,如HRB400E。

Gg

String

产品规格, 如12。

Width

String

宽度 ,如1010。

Height

String

长度 ,如12000。

ProductArea

String

生产厂家 ,如普阳。

DeliveryArea

String

交货地点 ,如邯郸。

StockArea

String

交货仓库 ,如中贸库。

Price

Int

价格(元/吨) ,是数字,如4500。若无价格赋值0

CaiGouPrice

Int

采购价格(元/吨) ,是数字,如4500。若无价格赋值0

Ton

decimal

吨位 重量(吨) 吨位必须大于0数字支持4位小数,如95.0351。

CalcWeight

String

计重方式 取值为“过磅,理计,出厂标签”, 如过磅。

Unit

String

单位取值为“件 支 张 捆” ,如 支。

Quantity

Int

H型钢必须上传数量 ,如10000。

Remark

String

产品备注说明

 

 

2.2.4 请求示例


{

  "AppID": "xxxxxx",

  "Access_Token": "F6D1D5E9FF359F286C0B8E8D4D5CC954",

  " EpID": 2,

  "IsFull": 0,

  "Products": [

    {

      "Number": "1",

      "Pm": "螺纹钢",

      "Cz": "HRB400E",

      "Gg": "12",

      "Width": "",

      "Height": "",

      "ProductArea": "桂鑫",

      "DeliveryArea": "滁州",

      "StockArea": "钢厂库",

      "Price": "3500",

      "CaiGouPrice": "3500",

      "Ton": "5000.1234",

      "CalcWeight": "过磅",

      "Unit": "",

      "Quantity": "0",

      "Remark": ""

    },

    {

      "Number": "1",

      "Pm": "螺纹钢",

      "Cz": "HRB400E",

      "Gg": "10",

      "Width": "",

      "Height": "",

      "ProductArea": "桂鑫",

      "DeliveryArea": "滁州",

      "StockArea": "钢厂库",

      "Price": "3500",

CaiGouPrice": "3500",

      "Ton": "5000",

      "CalcWeight": "过磅",

      "Unit": "",

      "Quantity": "0",

      "Remark": ""

    }

  ]

}

2.1.5 响应参数


 参数名称

类型

必填

描述 

result

Int

1成功,0 失败

msg

String

错误消息

  

响应示例

上传成功的示例

{

  "result": 1,

 "msg": "导入成功100条"

 

上传失败的示例

{

  "result": 0,

  "msg": "第1条数据的材质不能包含汉字,第1条数据的重量(吨)必须是数字,"

}



          


Copyright © 2005 - 2024 中钢网 All Rights Reserved

全国咨询/投诉电话:400-700-8508 E-mail:kf@steelcn.com 豫ICP备2021034665号-4