易仓平台对接指南

 说明：本文主要是介绍易仓自研应用连接器获取及设置、接口请求类型（post,get),方案配置设置指南，适配器介绍。

一：连接器获取指南

1.1：API接口文档地址

文档地址：https://open.eccang.com/#/documentCenter?docId=307&catId=0-172-172,0-171

1.1.1:在 生态中心-》应用管理 创建应用：

链接地址：https://home.eccang.com/#/company/develop/app-manager

1.1.2:查看已经创建的应用：

链接地址：https://home.eccang.com/#/company/develop/app-manager

参数说明：
host:http://openapi-web.eccang.com/openApi/api/unity(接口请求地址,固定是这个)
app_key:应用key
app_secret:应用密钥
service_id:接口服务id,

在应用管理中，在授权状态中，点击查看。就可以得到service_id。

二: 方案配置指南

2.1：适配器介绍

EcCangV2ExecuteAdapter：写入适配器，
EcCangV2QueryAdapter：查询适配器，

2.2：方案配置示例

示例方案：https://pro.qliang.cloud/strategy/strategy/detail/247610ed-9398-3abd-922d-f2ea7603954d#BasicSummary

2.3：请求参数说明

2.3.1：api参数说明：

查看接口文档，如：https://open.eccang.com/#/documentCenter?docId=111803&catId=0-189-189,0-177
请求方法：
getShipAddressBooks，这个就是api接口信息

2.3.2：request参数配置指南：

    page:页码
    page_size:每页条数
    posted_date_site_from:开始出库时间
    posted_date_site_to:结束出库时间

2.3.3：其它请求参数-otherRequest

如果接口签名顺序与默认的签名顺序不一致，就需要配置其它请求参数，如果一致则不需要配置。整个配置顺序需要和接口提供的一样，否则会报签名错误
默认签名字段

'app_key'
'biz_content'
'charset'
'interface_method'
'nonce_str'
'service_id'
"sign" =>'',
'sign_type'
'timestamp'
'version'

    app_key:应用KEY(填入app_key,会取连接器的app_key)
    biz_content:请求头参数(填入biz_content,会对上面的request参数json格式化)
    charset:字符内容（默认:UTF-8)
    interface_method:接口请求api(会取当前方案配置的API)
    nonce_str:随机字符串，需要配置
    service_id:服务id(填入service_id,会取连接器的service_id)
    sign:签名(填入sign,会自动生成签名)
    sign_type:签名类型(默认:MD5)
    timestamp:时间戳(填入timestamp,每次请求会使用新的时间戳)
    version:版本号(默认:1.0.0)

2.3.4：其他响应参数

statusKey:响应状态字段
statusValue:成功状态值
dataKey:返回数据字段
pageKey:分页字段

2.3.5:特殊格式处理

在有些情况下，需要对数据进行特殊格式的转换。变成二维数组。
如：

{
    "default_purchase_cost_fee": -0.16,
    "default_purchase_fee": -0.16,
    "default_purchase_shipping_fee": 0,
    "default_purchase_tariff_fee": 0
}

需要所数据转成如下格式，变成一个键值对固定的格式，保留key：，value:格式。

{"_Fcost": [
    {
      "key": "default_purchase_cost_fee",
      "value": -123.86
    },
    {
      "key": "default_purchase_fee",
      "value": -123.86
    },
    {
      "key": "default_purchase_shipping_fee",
      "value": 0
    }
  ]}

哪在这里面就

就是在其他响应参数中，配置第四值。设置需要转换的key.

statusKey:响应状态字段
statusValue:成功状态值
dataKey:返回数据字段
pageKey:分页字段
cost_array_key:需要变成二维数组的key