闲管家开放平台
    • 接入说明
    • 代码示例
    • 接入教程-服务商模式
    • 服务商模式-订购说明
    • 用户
      • 授权商家账号（服务商）
        POST
      • 创建商家账号（服务商）-废弃
        POST
      • 删除商家账号（服务商）
        POST
      • 查询商家账号（服务商）
        POST
      • 授权闲鱼店铺（服务商）
        POST
      • 删除闲鱼店铺（服务商）
        POST
      • 查询闲鱼店铺
        POST
      • 查询商家地址
        POST
    • 商品
      • 查询商品类目
        POST
      • 查询商品属性
        POST
      • 查询商品列表
        POST
      • 查询商品详情
        POST
      • 查询商品规格
        POST
      • 创建商品（单个）
        POST
      • 创建商品（批量）
        POST
      • 上架商品
        POST
      • 下架商品
        POST
      • 编辑商品
        POST
      • 编辑库存
        POST
      • 删除商品
        POST
    • 订单
      • 查询订单列表
        POST
      • 查询订单详情
        POST
      • 订单卡密列表
        POST
      • 订单物流发货
        POST
      • 订单修改价格
        POST
      • 订单修改地址详情
        POST
      • 订单修改地址审核
        POST
      • 修改快递单号
        POST
      • 无需物流发货
        POST
    • 售后
      • 售后订单列表
      • 售后订单详情
      • 售后订单同意退款
      • 售后订单拒绝退款
      • 售后订单拒绝原因
    • 推送
      • 商品回调通知
      • 商品推送通知
      • 订单推送通知
    • 资金
      • 查询钱包账户余额（服务商）
      • 订购ERP专业版（服务商）
    • 其他
      • 查询快递公司
    • 卡密
      • 卡密分类编辑
      • 卡密分类创建
      • 卡密分类删除
      • 卡密分类列表
      • 发卡组合创建
      • 发卡组合删除
      • 发卡组合修改
      • 发卡组合列表
      • 发卡组合更新状态
      • 卡种列表
      • 卡种创建
      • 卡种删除
      • 卡种详情
      • 卡种编辑
      • 卡种添加卡密库存

    接入教程-服务商模式

    📢必要条件：因为需要写接口，必须要有代码开发能力，没有开发能力可以选择使用应用市场-进销存应用#

    常见问题答疑#

    1.
    Q：为什么调用接口提示【应用不存在或已下线】
    A：应用必须是进销存类型的应用appkey，并且应用必须上线才可以使用接口
    2.
    Q：为什么已经创建商品成功了，但是闲鱼APP还看不到商品
    A：创建成功还需要【上架商品】API，上架成功才能在闲鱼销售
    3.
    Q：【查询商品列表】、【查询订单列表】没有看到店铺搜索参数
    A：涉及到系统架构、数据量的问题，暂时只支持简单参数查询，更多参数需要去商品、订单详情接口获取
    接口生效范围是当前管家账号下有开发平台权益的闲鱼店铺，订购ERP专业版或者铂金版都可以；
    如果想要区分店铺使用，只能对这个闲鱼店铺使用单独的管家账号，然后创建应用使用
    4.
    Q：API请求有什么限制没？
    A：一个闲管家账号所有请求接口总和 QPS=20次/秒，每个商家每个API日调用限额100000次，如果某个商家请求QPS不够用的话，可以在：开放平台 / 应用 / 我的应用页面，操作【订购QPS】
    限流返回异常为：请求异常，请稍后重试、请求限流，请稍后重试
    5.
    Q：为什么查不到商品详情数据？
    A：product_id为闲管家商品ID, item_id为闲鱼商品ID, 不能混用
    6.
    Q：创建商品参数images 商品图片URL 有什么要求？
    A：不能使用本地图片，只能使用国内可以访问的公网图片地址，支持：http/https、域名/IP
    7.
    Q：是否支持API图片上传
    A：不支持图片上传，只能使用图片链接，链接要求见问题6
    8.
    Q：个人卖家账号及鱼小铺是否可以接入？
    A：正常使用的店铺都可以，企业店铺也可以
    9.
    Q：是否提供试用或沙箱环境？
    A：在闲管家首次绑定过的闲鱼店铺有7天试用，没有沙箱环境，也不提供测试账号（包含闲管家账号+闲鱼账号）
    10.
    Q：是否提供闲鱼消息/聊天 API？
    A：目前不支持，后续也不支持
    11.
    Q：曝光量、浏览量、想要/收藏、咨询数、搜索排名等数据是否能通过接口获取
    A：目前不支持
    12.
    Q：上架商品失败，失败原因：未开通服务或当前品类不支持开通服务; [2]-[99]
    A：service_support 商品服务不是传参就能用的，闲鱼APP要开通相关服务才能使用
    13.
    Q：每个闲管家账号可以管理多少店铺
    A：使用对接方式1：一个闲管家账号可以绑定30个闲鱼店铺，超过只能换个闲管家账号
    使用对接方式2：闲管家账号和闲鱼店铺是一对一的关系
    服务商模式可以管理很多闲管家账号
    对接方式见下方【对接方式参考】部分
    14.
    Q：店铺授权问题
    A：每次闲鱼店铺授权有效期为半年，授权过期无法管理商品、订单；
    过期时间可以在【查询闲鱼店铺】返回的authorize_expires查看
    授权过期需要走下【授权闲鱼店铺（服务商）】这一步，不支持自动授权
    15.
    Q：推送签名规则是怎么样的？
    A：【商品回调通知、商品推送通知、订单推送通知】三个推送接口是闲管家请求你的系统，请求参数没有seller_id，签名规则为：签名值 = md5("应用KEY,Body报文Md5值,时间戳,应用密钥")
    16.
    Q：已经在闲管家渠道订购了ERP专业版或者铂金版，能给服务商使用吗
    A：不能，服务商的用户只能使用通过【订购ERP专业版（服务商）】订购的版本
    17.
    Q：在闲管家订购的版本能转换为服务商版本吗
    A：目前不行
    18.
    Q：每个用户的appKey 、appSecret怎么获取
    A：不需要获取，所有用户都使用服务商应用的appKey 、appSecret
    19.
    Q：seller_id是否必传
    A：服务商模式除非有特别说明，接口的seller_id是要传参的
    1、不用传seller_id的API:【授权商家账号（服务商）】、【资金】下面的两个API 、【查询快递公司】
    2、如果对接方式使用方式二，【授权闲鱼店铺（服务商）】 seller_id可不传或seller_id=0
    20.
    Q：商品创建、编辑的地区参数从哪里来？
    A：见接入说明页面的【闲管家省市区】
    21.
    Q：服务商渠道订购的ERP专业版是否有折扣？
    A：目前的优惠是闲管家官网ERP专业版的85折
    22.
    Q：闲鱼商品ID哪个接口可以看到（商品发布成功才有）
    A：商品详情API：data . publish_shop . item_id
    商品回调通知：item_id
    23.
    Q：闲鱼账号怎么识别
    A：user_name 闲鱼会员名（目前闲鱼没有修改的入口，可以认为不会更改）、user_identity 闲鱼会员ID（不会更改）
    同一个闲鱼号从A闲管家账号绑定到B闲鱼账号，seller_id、authorize_id会更新，user_name、user_identity不会更新
    24.
    Q：服务商想要获取类目属性数据怎么解决
    A：1、使用自研进销存，直接调用【查询商品类目】 + 【查询商品属性】
    2、按照服务商模式处理，完整走完授权流程，再使用【查询商品类目】 + 【查询商品属性】
    25.
    Q：服务商使用【订购ERP专业版（服务商）】订购的版本是否可以退款
    A：不支持退款，可以转移到其他闲鱼店铺，反馈到对接群或者找在线客服都可以，
    反馈示例：把服务商版本 A闲鱼店铺 转移到 B闲鱼店铺
    26.
    Q：订购是按闲管家账号还是按闲鱼店铺？
    A：按店铺维度订购，每个闲鱼店铺都要订购（这点和闲管家网页版订购模式一样的）

    一、订购可使用开放平台的版本#

    注意高级版不能创建应用，只有ERP专业版、铂金版才可以
    选择试用或者订购，只是为了对接调试应用的话，可以按月订购
    image.png

    二、创建自研系统-进销存类型应用#

    image.png
    进入【我的应用】列表，查看刚刚创建的应用
    image.png

    三、把创建的应用ID 提供到对接群#

    ⚠️这一步是把自研应用升级为服务商版本，文档里服务商的相关接口才能使用
    升级为服务商应用类型后，应用不可以下架、删除
    如需更换商品、订单推送地址，请前往对接群说明

    四、应用详情说明#

    应用概况：
    AppKey：对接接口时签名使用
    AppSecret：对接接口时签名使用
    > > 服务商模式，所有用户都使用这一组参数
    消息推送地址
    1、服务商模式只能有闲管家技术配置商品、订单推送地址
    2、订单、商品推送的参数见API文档【推送】部分
    image.png

    五、接口使用#

    签名规则见【接入说明】

    📢 注意：签名body里面的参数不用排序，传参body是什么，原样参与签名#

    body一定要使用压缩后的json，示例：{"keyword":"","goods_type":2,"page_no":1,"page_size":50}
    body有中文、链接也原样传参，不要编码
    image.png

    1、商品相关接口#

    【创建商品】使用的图片地址必须是公网可以访问的图片链接
    商品上架、编辑存在发布失败的可能，需要notify_url接收操作结果
    ec25f95060c2fa977e9d3de83ea28c8e.png

    对接方式参考#

    9e67e06140b8f99f632a86ca29cc05e6.png

    方式1：#

    1、用户打开页面【授权闲管家账号地址】 得到授权authorize_code
    2、把第1步得到授权authorize_code，传参请求API【授权商家账号（服务商）】 得到seller_id
    3、打开页面【授权闲鱼店铺地址】 登录闲鱼账号，得到闲鱼授权authorize_code
    4、把第2步得到的seller_id + 第3步得到的授权authorize_code， 传参请求API【授权闲鱼店铺（服务商）】 得到店铺信息

    方式2：#

    1、打开页面【授权闲鱼店铺地址】 登录闲鱼账号，得到闲鱼授权authorize_code
    2、不传seller或者seller_id=0 + 第1步得到的授权authorize_code，传参请求API【授权闲鱼店铺（服务商）】 得到店铺信息

    订购【服务商ERP专业版】说明#

    服务商需要先充值到余额，才能订购成功
    image.png
    bd16122e31eddfd2a384f114d7f60be2.png

    开放平台SDK#

    如有使用问题，可反馈到闲管家开放平台对接群
    PHP_SDK 点击下载 更新日期：20260623，增加售后相关API, 支持的PHP版本：php7+（其他版本需自行测试）
    GO_SDK 点击下载 更新日期：20260623，增加售后相关API, 支持的Go版本：Go 1.26+（其他版本需自行测试）
    Python_SDK_点击下载 更新日期：20260623，增加售后相关API, 支持的python版本：3.7 ~ 3.12（其他版本需自行测试）
    修改于 2026-10-21 02:40:38
    上一页
    代码示例
    下一页
    服务商模式-订购说明
    Built with