易仓自研应用连接器获取及设置指南

本文将详细介绍如何获取和设置易仓自研应用连接器，包括接口请求类型（POST, GET）、方案配置设置以及适配器的使用。

连接器获取

API接口文档地址

您可以通过以下链接访问API接口文档： https://open.eccang.com/#/documentCenter?docId=307&catId=0-172-172,0-171

创建与查看应用

在生态中心的应用管理中，创建和查看您的应用： 创建应用 查看已创建的应用

参数说明：

• host：http://openapi-web.eccang.com/openApi/api/unity (固定请求地址)
• app_key：应用key
• app_secret：应用密钥
• service_id：接口服务id（在授权状态中点击查看即可获得）

方案配置

适配器介绍

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

配置示例

示例方案：点击这里查看示例

请求参数说明

API参数说明

具体API参数请参考文档： API文档 例如，请求方法为getShipAddressBooks

request参数配置指南

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

#### 其它请求参数-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)

#### 响应参数说明

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

特殊格式处理

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

原始数据:

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

转换后的数据:

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

在其他响应参数中，配置需要转换的键值对：

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

![image](//pic.qeasy.cloud/2024-03-13/1710313761-153256-image.png)

以上内容涵盖了易仓自研应用连接器获取及设置、接口请求类型、方案配置等方面，希望能对你有所帮助。