获取店铺绑定码

用于技术接入：服务端调用蜂巢开放接口生成店铺绑定码，再在桌面助手中输入该码完成店铺绑定。

绑定码有效期 30 分钟，格式为 XXXX-XXXX-XXXX（12 位，已排除易混淆字符）。店铺须已在开放平台完成授权（当前支持淘宝店铺）。

使用流程

开发者服务端调用本接口，传入已授权的 sellerNick
拿到 bindingCode，展示给商家或写入二维码/短链
商家在桌面助手「绑定店铺」中输入绑定码并确认
桌面助手完成设备绑定后即可领取该店铺的发布任务

请求说明

POST https://kf.fw199.com/gateway/rpa/binding-codes

Content-Type：application/x-www-form-urlencoded（与开放平台其它网关接口一致，需带签名公共参数）。

公共参数

参数名	类型	必填	说明
appid	String	是	开放平台应用 AppId
timestamp	String	是	当前时间戳（秒）
sign	String	是	接口签名，算法与开放平台其它接口相同（见 SDK 示例）

业务参数

参数名	类型	必填	说明
sellerNick	String	是	已授权店铺的卖家昵称（淘宝 seller_nick）。须属于当前 appid 下已授权店铺，否则返回未授权错误

Java 示例

依赖开放平台通用签名工具（与其它网关接口相同）。Config / Utils.Sign / doHttpRequest 可参考 zeroone-opensdk 或现有接入工程。

@Test
public void createBindingCode() throws Exception {
    String apiUrl = Config.baseUrl + "/gateway/rpa/binding-codes";
    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("sellerNick", Config.TBSellerNick);
    data.put("sign", Utils.Sign(data, Config.AppSecret));
    doHttpRequest(apiUrl, data);
}

说明：

Config.baseUrl 生产环境一般为 https://kf.fw199.com
Utils.Sign 对参与签名的字段（含 appid、timestamp、sellerNick）按开放平台规则计算
成功时响应 data.bindingCode 即为绑定码

返回说明

统一结构：code / message / data。code = 0 表示成功。

成功示例

{
  "code": 0,
  "message": "success",
  "data": {
    "bindingCode": "A3K9-P2M7-X4Q8",
    "expiresIn": 1800,
    "expiresAt": "2026-10-17 16:30:00"
  }
}

data 字段

字段	类型	说明
bindingCode	String	绑定码，展示给商家在桌面助手中输入
expiresIn	Number	有效秒数，当前固定为 1800（30 分钟）
expiresAt	String	过期时间，格式 `yyyy-MM-dd HH:mm:ss`（东八区）

常见错误

code	说明
100	应用 appid 不能为空
102	查询合作伙伴出错
105	签名失败
400	sellerNick required
40301	SHOP_NOT_AUTHORIZED：店铺未授权或不属于当前应用
500	生成或保存绑定码失败

注意事项

绑定码仅可被桌面助手消费一次；过期或已使用需重新申请。
请勿将绑定码长期展示在公开页面；建议按需生成、短时有效。
SDK 与签名示例见：https://github.com/CheeliAI/zeroone-opensdk
开发者控制台：https://console.fw199.com