跳转到: 导航, 搜索

电商服务商平台能力接口

提供给电商服务商的平台能力,目前包含订单能力接口、商品能力接口。


电商服务商接口验证签名

调用电商服务商接口需带上验证签名的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 获取商家信息


附录

订单能力接口中需要用到的各种编码对照表。






文档更新时间: 2022-09-05