查询商家订购情况

查询商家是否订购了蜂巢的第三方平台应用情况,即商家是否订购了淘宝服务市场的“智能发货”或拼多多服务市场“千里马”。 对于蜂巢开发者而言,如果发现商家未订购,可让商家跳转到上述应用的订购页面。订购完成后,再让商家授权给自己。

1.请求参数:

POST https://kf.fw199.com/gateway/partner/seller/subscribe

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
seller_nick String 淘宝或拼多多商家账号,注意要和channel参数匹配 kingdo
channel String 订购平台, 1:淘宝 2:拼多多 3: 抖店 4:京东
sign String 接口签名 如何计算生成见示例代码

2. 请求示例代码(Java)

   /**
     *  检查商家订购情况
     * @throws Exception
     */
    @Test
    public void  PartnerSellerSubscribe() throws Exception { 
        //   1:淘宝 2:拼多多  3: 抖店 4:京东
        String channel = "2";
        // 淘宝/拼多多商家账号
        String  seller_nick = "pdd43901635752";
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("seller_nick", seller_nick); 
        data.put("channel",channel);
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.PartnerSellerSubscribeUrl ,data);

    }

3. 返回结果如下:

{
    "code": 0,
    "message": "ok",
    "data": {
        "dead_line": "2022-03-13 00:00:00",
        "is_valid": true,
        "granted": true,
        "need_op_reauth": false
    },
    "trace_id": ""
}

说明: code为0表示成功,非0为失败,message会包含失败原因,其他字段说明:

参数名 类型 说明 建议处理
dead_line String 订购到期时间 此字段仅参考,个别商家可能中间退款
is_valid bool 商家是否已经订购应用, true表示已订购,false: 表示未订购 根据是淘宝还是拼多多,还跳到服务的订购页面
need_op_reauth bool 商家是否要重新授权,true:表示要重新授权给蜂巢,false:表示不需要重新授权蜂巢 。 商家有可能到期未续费, 在重新续费后,需要重新授权给淘宝的“智能发货”或是拼多多的“千里马” 建议重新授权给蜂巢开发者。即网页跳转到让商家授权给您的页面
granted bool 是否已经授权给蜂巢开发者 ,true:表示商家已经授权蜂巢开发者,false:表示未授权给蜂巢开发者。 需要商家授权给您。 即网页跳转到让商家授权给您的页面

3. 相关链接:

各市场订购地址

  1. 淘宝服务市场订购:
    1.1 订单相关请订购: https://kf.fw199.com/app/100 ,订购高级版或天猫专用
    1.2 商品相关请订购:https://kf.fw199.com/app/102
  2. 拼多多服务市场订购: https://fuwu.pinduoduo.com/service-market/service-detail?detailId=46615
  3. 抖店服务市场订购: https://fuwu.jinritemai.com/detail?service_id=23042
  4. 京东服务市场订购: https://fw.jd.com/main/detail/FW_GOODS-1581601
文档更新时间: 2023-04-11 10:56   作者:admin