新旧平台关系
新开放平台和旧开放平台是同一套吗？
不是。两套是完全独立的。新开放平台 域名、接口路径、鉴权方式、计费方式、控制台和回调配置都与旧开放平台不同。
已经接了旧开放平台，还需要改造吗？
如果继续使用旧平台已有接口，无需改造，可以继续使用。 如果要使用新平台提供的新接口、新控制台、回调或 Token 计费能力，则需要按新平台文档重新完成鉴权、签名和接口联调。
同一个客户能同时使用两套开放平台吗？
可以。两套平台可以并行使用，但鉴权参数、接口地址、回调配置、调用日志和费用统计分别管理。 旧版开放平台后续不再维护。建议都用新的。
旧开放平台购买的调用次数，回调服务可以用在新开放平台吗？
不行。旧开放平台 收费分为 调用次数 和 回调服务。旧平台购买的调用次数和回调服务只能在旧平台使用，不能迁移到新平台。 新开放平台支持 Token 计费和年度固定费两种方式。年度固定费分为接口版、接口+回调版，由平台运营人员按合同开通。
旧开放平台的appId,appKey可以直接用于新开放平台吗？
可以。为了减轻客户迁移成本，旧平台申请的 appId 和 appKey 也可以用于新平台鉴权和接口调用。但需要注意：新平台的接口地址、鉴权方式、计费方式和控制台都与旧平台不同，客户需要按照新平台文档完成接口改造和联调。
新旧平台对比
新版开放平台重点解决连锁门店凭证维护、按需计费、控制台调试、调用日志和回调配置灵活性问题。
| 对比项 | 旧开放平台 | 新开放平台 | 说明 |
|---|---|---|---|
appId / appKey |
连锁门店每家门店都需要一组 appId、appKey。如果有 50 家门店，需要申请并维护 50 组凭证。 |
连锁门店只需要总部申请一组 appId、appKey，即可访问总部权限范围内所有连锁门店数据。 |
接入和密钥维护成本明显降低，尤其适合多门店、连锁客户。 |
| 计费方式 | 按接口调用次数 跟 回调 2种方式计费 | 支持按 Token 计费，也支持接口版、接口+回调版年度固定费。 | 小客户可以按实际用量付费，大客户也可以提前锁定全年预算。 |
| 使用灵活性 | 需要提前估算每天调用次数，容易买多浪费、买少不够。618、双 11 等高峰期容易出现调用次数不足。 | Token 客户保持余额即可持续调用；有效期客户在权益范围内无需消耗 Token，到期后自动使用 Token 余额。 | 既适合业务量波动明显的客户，也适合需要固定年度预算的大客户。 |
| 接口调试 | 没有控制台，需要一定技术水平才能跑通接口。 | 输入 appId、appKey 登录控制台后，可以选择任一接口进行调试。 |
降低联调门槛，客户可以更快跑通完整流程。 |
| 调用日志 | 查看不方便。 | 控制台可以完整查看调用链路，例如什么时间调用了哪个接口、调用结果、消耗了多少 Token。 | 后续排查问题更直接，减少人工沟通成本。 |
| 回调地址 | 只支持一个回调地址。 | 支持多个回调地址。 | 可以适配多系统、多业务线接收回调的场景。 |
| 回调事件 | 推送所有事件，无法灵活选择。 | 可以按需订阅回调事件。例如只关心商品变更，就订阅 product.change；只关心销售单据，就订阅 ticket.change。 |
减少无效回调，降低客户系统处理压力。 |
为什么新版要用 Token 计费？
说明：本文中的 Token 指开放平台用于衡量接口资源消耗的计费单位，不是大模型中的 Token。
我们借鉴了大模型 Token 的计量思路：一次对话中，请求内容、返回内容、模型处理复杂度不同，消耗的 Token 数也不同。开放平台的一次接口请求也是类似的逻辑，客户获取的数据范围不同，涉及的表、字段、图片、扩展信息不同，对系统资源的消耗也不同，所以对应消耗的 Token 数也不同。
新版按 Token 计费，是为了支持按需获取。 以查询商品接口为例，银豹商品数据涉及非常多的表，比如商品基础数据表（条码、库存、价格）、商品口味表、商品标签表、商品扩展条码表、商品图片表等。 如果一次请求把所有数据都返回，接口压力会很大；如果拆成多次请求，客户接入成本又会变高。
不同客户需要的数据范围不同。如果只按调用次数收费，A 客户只要商品基础数据，B 客户要商品基础数据、商品图片和扩展条码，两者的成本无法区分。
引入 Token 后：A 客户只获取商品基础数据，消耗 100 Token；B 客户获取商品基础数据 + 商品图片 + 扩展条码，消耗 100 + 20 + 20 = 140 Token。
这样既保留了一次请求按需获取多类数据的便利性，也能让计费更贴近真实资源消耗，避免简单按调用次数收费带来的不公平。
总结
- 新版开放平台是我们后续重点推荐的开放能力，接入方式更简单。客户只需要总部一组
appId和appKey，就能获取总部下所有门店数据。 - 新版平台提供完整控制台，客户可以自助查看接口、调用日志、回调日志和请求情况，后续排查问题会更方便。
- 计费方式也更灵活，按实际 Token 消耗扣费，只要账号余额充足即可持续调用，更适合多门店和业务量有波动的客户。
- 回调方面，新版平台支持按需配置事件和多个回调地址。客户可以只接收自己需要的业务事件，例如只接收销售单据变更，不接收商品、会员变更。