查询商家订购情况
查询商家是否订购了蜂巢的第三方平台应用情况,即商家是否订购了淘宝服务市场的“智能发货”或拼多多服务市场“千里马”。 对于蜂巢开发者而言,如果发现商家未订购,可让商家跳转到上述应用的订购页面。订购完成后,再让商家授权给自己。
1.请求参数:
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
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 订单相关请订购: https://kf.fw199.com/app/100 ,订购高级版或天猫专用
1.2 商品相关请订购:https://kf.fw199.com/app/102 - 拼多多服务市场订购: https://fuwu.pinduoduo.com/service-market/service-detail?detailId=46615
- 抖店服务市场订购: https://fuwu.jinritemai.com/detail?service_id=23042
- 京东服务市场订购: https://fw.jd.com/main/detail/FW_GOODS-1581601
文档更新时间: 2023-04-11 10:56 作者:admin