第123行: | 第123行: | ||
==附录== | ==附录== | ||
+ | |||
+ | <div class="wiki_txtJ"> | ||
+ | 订单能力接口中需要用到的对照表。 | ||
+ | </div> | ||
<div class="wiki_title_withline">订单类型对照表</div> | <div class="wiki_title_withline">订单类型对照表</div> |
2022年9月5日 (一) 16:11的版本
电商服务商平台能力接口
提供给电商服务商的平台能力,目前包含订单能力接口、商品能力接口。
电商服务商接口验证签名
调用电商服务商接口需带上验证签名的sign参数,其生成方法为:将调用接口的参数,过滤掉不参与签名的参数后,按照键名进行升序排序,之后转换为URL查询字符串(querystring),并在结尾拼接上秘钥(appkey 对应的 app secret),最后将得到的字符串进行md5,得到最终的sign值。
不参与签名的参数,参数名为sign、sign_type、access_token的参数,和参数值为空字符串的参数。
签名方法示例:
CODE:PHP
public static function getSign($data_list, $key, $filter_k_list = ["sign", "sign_type", "access_token",], $filter_v_list = ["",]) { // 过滤不参与签名的参数 foreach ($data_list as $k => $v) { if (in_array($k, $filter_k_list, true) || in_array($v, $filter_v_list, true)) { unset($data_list[$k]); } } // 进行排序 ksort($data_list); // 转换为查询字符串,注意过滤前后空格 $parameter = []; foreach ($data_list as $k => $v) { $parameter[] = $k . "=" . trim($v); } $string = implode("&", $parameter); // 拼接密钥 $stringKey = $string . $key; // 进行MD5得到最终签名 $sign = md5($stringKey); return $sign; }
订单能力接口
订单业务相关的接口,详细见接口列表:
接口 | 说明 |
---|---|
order/retailerGetSubList | 获取子订单列表 |
order/retailerGetSub | 获取子订单详情 |
order/retailerAddExpress | 提交发货 |
order/retailerSetReceiverInfo | 修改收货人信息 |
order/retailerSetRetailerRemark | 修改商家备注信息 |
商品能力接口
商品业务相关的接口,详细见接口列表:
接口 | 说明 |
---|---|
goods/online | 商品上架 |
goods/offline | 商品下架 |
goods/getGoodsInfo | 根据商品ID查询商品信息 |
goods/getGoodsList | 根据商品更新时间查询商品信息 |
goods/getShopInfo | 获取商家信息 |
附录
订单能力接口中需要用到的对照表。
订单类型对照表
订单状态码对照表
快递公司编码与名称对照表