购印权益文档站

主题

闲管家对接购印权益 ​

新手教程约 5~10 分钟按顺序操作

这篇文档适合第一次操作的用户。你只需要跟着步骤完成：开通闲管家应用 → 获取购印权益接口信息 → 配置白名单 → 回到闲管家保存并测试。

开始前先准备好

  • 一个可以正常登录的 闲管家账号
  • 一个可以正常登录的 购印权益账号
  • 购印权益已经完成 API 开通 和 实名
  • 一个可接收验证码的邮箱
  • 最好同时打开两个页面：闲管家后台 和 购印权益后台

先看一眼整体流程 ​

  1. 在闲管家开通「购印」应用
  2. 在购印权益获取 APPID 和 密钥
  3. 给购印权益添加闲管家服务器白名单 IP
  4. 回到闲管家填写 AppKey 和 AppSecret
  5. 保存后确认上线，再测试商品发货

重要提醒

  • APPID 和 密钥 很重要，不要发给别人。
  • 如果你还没有开通购印权益 API，或者还没有实名，请先完成这两步，再继续往下操作。

第一步：先开通闲管家里的购印应用 ​

如果你还没有开通闲管家会员，请先到闲管家官网完成开通。

我们和闲管家有合作，如果你需要邀请码，可以前往购印权益官网了解：by.ve2.cn。

开通后，在闲管家后台依次点击：应用 → 我的应用。

闲管家-我的应用

然后点击「添加应用」。

闲管家-添加应用

接着选择「从应用市场选择」，再在下方搜索栏搜索：购印。

点击「开通」按钮即可。

闲管家-从应用市场选择

闲管家-开通购印应用

第二步：去购印权益获取接口信息 ​

打开购印权益官网：by.ve2.cn

点击右上角的：个人中心 → 用户中心。

购印权益-进入用户中心

然后进入：账户管理 → 接口管理。

如果你不记得自己以前生成过的密钥，可以直接点击「重置」。

这里的 APPID 和 密钥 是什么？

  • APPID：可以理解为接口账号标识
  • 密钥：可以理解为接口密码

后面在闲管家里要分别填写到对应位置。

购印权益-接口管理与重置

第三步：完成验证并拿到 APPID 和密钥 ​

重置时需要验证码。这里以 邮箱验证 为例：点击「获取验证码」。

购印权益-获取邮箱验证码

然后打开你的邮箱。

如果收件箱里没有收到邮件，可以去垃圾箱里找一下。

复制邮件里的验证码数字。

邮箱-验证码邮件

回到购印权益页面，输入验证码，然后点击「确认」。

购印权益-输入验证码确认

确认后，你就能看到自己的 API密钥 和 APPID。

请把这两个信息保存好，后面会马上用到。

购印权益-显示APPID和密钥

注意

这两个信息很重要，请自己保存，不要随意发给别人。

第四步：把闲管家服务器 IP 加入白名单 ​

还在购印权益这个页面，找到「白名单IP」。

这里需要填写 闲管家的服务器 IP，然后点击「保存信息」。

什么是白名单 IP？

可以把它理解成：允许哪些服务器来访问你的接口。

如果白名单没加好，后面在闲管家里通常会对接失败。

注意：闲管家 IP 可能会变动，具体以闲管家客服提供的信息为准。

下面是原文中的 IP 范围，请按实际需要填写：

text
112.74.0.0 - 112.74.255.255
120.24.0.0 - 120.24.255.255
120.78.0.0 - 120.78.255.255
120.79.0.0 - 120.79.255.255
39.108.0.0 - 39.108.255.255
47.106.0.0 - 47.106.255.255
120.77.0.0 - 120.77.255.255

购印权益-白名单IP位置

购印权益-保存白名单信息

第五步：回到闲管家填写接口参数 ​

现在回到闲管家刚才的配置页面，把你保存下来的接口信息填进去。

对应关系如下：

购印权益里的名称闲管家里对应填写的位置
APPIDAppKey
密钥AppSecret

填好后，建议你自己再核对一遍，确认没有填错，再点击保存。

闲管家-填写AppKey和AppSecret

保存后，如果页面提示「保存成功」，说明这一步已经完成。

闲管家-保存成功提示

接着点击「确认上线」。

闲管家-确认上线

第六步：测试商品发货是否正常 ​

下面以 发卡 为例，演示怎么测试。

在闲管家后台左侧依次点击：发货 → 发货设置。

闲管家-进入发货设置

找到你的闲鱼商品。

如果没有显示，可以先尝试同步；如果确认有商品但还是不显示，再咨询闲管家客服。

找到商品后，点击「修改设置」。

闲管家-修改发货设置

然后按下面方式填写：

  • 内容方式：勾选 货源
  • 关联货源：选择 购印权益
  • 关联商品：可以搜索商品标题

如果能正常显示 商品价格 和 库存，一般就说明关联成功了。

闲管家-关联货源与商品成功示例

商品搜索怎么填？ ​

你可以用两种方式搜索：按商品标题搜索 或 按商品编码搜索。

方式一：按商品标题搜索 ​

当你打开购印权益的商品详情页时，商品页面上的这个名称，就是「商品标题」。

购印权益-商品标题位置1

购印权益-商品标题位置2

方式二：按商品编码搜索 ​

如果你不想按标题搜，也可以直接按编码搜索。

闲管家-按编码搜索

「商品编码」就是商品详情中的这个编号位置。

购印权益-商品编码位置1

购印权益-商品编码位置2

常见问题 ​

1）保存成功了，但还是对接不上 ​

先优先检查这 3 个地方：

  1. APPID 和 密钥 有没有填反
  2. 白名单 IP 有没有保存成功
  3. 你填写的闲管家服务器 IP 是不是最新的

2）找不到商品 ​

可以按下面顺序检查：

  1. 先在闲管家同步商品
  2. 再确认商品标题或商品编码有没有填对
  3. 如果还是不显示，再联系闲管家客服处理

3）重置过密钥后不能用了 ​

这通常是因为你在购印权益重置了密钥，但闲管家里还填的是旧密钥。

处理方法很简单：重新复制最新的 APPID 和 密钥，再保存一次即可。

小结 ​

如果你已经完成下面这几步，就说明基本对接成功了：

  • 已在闲管家开通「购印」应用
  • 已在购印权益拿到 APPID 和 密钥
  • 已添加闲管家白名单 IP
  • 已在闲管家正确填写 AppKey 和 AppSecret
  • 已成功关联商品，并能看到价格和库存 🎉

如果你是第一次接入，建议先随便选一个商品做一次完整测试，确认流程没问题后，再正式使用。

© 2026 购印权益｜版权所有