查询商家订购情况
查询商家是否订购了蜂巢的第三方平台应用情况,即商家是否订购了淘宝服务市场的“智能发货”或拼多多服务市场“千里马”。 对于蜂巢开发者而言,如果发现商家未订购,可让商家跳转到上述应用的订购页面。订购完成后,再让商家授权给自己。
1.请求参数:
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
appid | String | 合作伙伴AppId | uwkahf@jfs92 |
timestamp | String | 当前时间戳 | |
seller_nick | String | 淘宝或拼多多商家账号,注意要和channel参数匹配 | kingdo |
channel | String | 订购平台, 1:淘宝, 2:拼多多, 3: 抖店, 4:京东 ,5:快手,6:1688 | 1 |
sysid | String | 此参数针对channel为淘宝时有效, 这3个应用之一,100, 102,103,若有不清楚请联系客服! | 100 |
sign | String | 接口签名 | 如何计算生成见示例代码 |
2. 请求示例代码(Java)
/**
* 检查商家订购情况
* @throws Exception
*/
@Test
public void PartnerSellerSubscribe() throws Exception {
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("sysid","100");
// 签名
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 | 订购是否在有效订购期内,即deadline是否在当前时间之后。 | 应用订购过期,重新订购应用服务。 |
need_op_reauth | bool | true: 需要商家重新授权给应用,false: 应用授权正常。 | 如果返回true, 需要商家在电商平台打开订购的应用,重新登录应用首页。 |
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
文档更新时间: 2024-12-19 13:40 作者:admin