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

    应用接入教程

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

    常见问题答疑#

    1.
    Q：为什么调用接口提示【应用不存在或已下线】
    A：应用必须是进销存类型的应用appkey，并且应用必须上线才可以使用接口
    2.
    Q：为什么已经创建商品成功了，但是闲鱼APP还看不到商品
    A：创建成功还需要【上架商品】API，上架成功才能在闲鱼销售
    3.
    Q：【查询商品列表】、【查询订单列表】没有看到店铺搜索参数
    A：涉及到系统架构、数据量的问题，暂时只支持简单参数查询，更多参数需要去商品、订单详情接口获取
    接口生效范围是当前管家账号下有开发平台权益的闲鱼店铺，订购ERP专业版或者铂金版都可以；
    如果想要区分店铺使用，只能对这个闲鱼店铺使用单独的管家账号，然后创建应用使用
    4.
    Q：API请求有什么限制没？
    A：一个闲管家账号所有请求接口总和 QPS=10次/秒， 每个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要开通相关服务才能使用

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

    注意高级版不能创建应用，只有ERP专业版、铂金版才可以
    选择试用或者订购
    image.png

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

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

    三、应用详情说明#

    应用概况：
    AppKey：对接接口时签名使用
    AppSecret：对接接口时签名使用
    消息推送地址
    1、如果需要接收商品、订单状态变更，可以填写推送URL，用不到可以不填写
    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
    也可以在商品列表/处理中看到这些发布失败的商品
    PS：如果看不到【失败原因】这一列，需要向右拉动页面底部的横向滚动条
    image.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-09-19 07:29:20
    上一页
    代码示例
    下一页
    查询闲鱼店铺
    Built with