闲管家开放平台
    • 接入说明
    • 代码示例
    • 应用接入教程
    • 用户
      • 查询闲鱼店铺
        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:涉及到系统架构、数据量的问题,暂时只支持简单参数查询,更多参数需要去商品、订单详情接口获取
    4.
    Q:API请求有什么限制没?
    A:一个管家账号所有接口的QPS默认为 10/秒,不够的话可以在我的应用页面,操作【订购QPS】
    5.
    Q:进销存应用可以指定闲鱼店铺使用吗?
    A:目前不支持指定闲鱼店铺,应用生效范围是当前管家账号下有开发平台权益的闲鱼店铺;
    如果想要区分店铺使用,只能对这个闲鱼店铺使用单独的管家账号,然后创建应用使用
    6.
    Q:为什么查不到商品详情数据?
    A:product_id为闲管家商品ID, item_id为闲鱼商品ID, 不能混用
    7.
    Q:创建商品参数images 商品图片URL 有什么要求?
    A:不能使用本地图片,只能使用国内可以访问的公网图片地址,支持:http/https、域名/IP

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

    注意高级版不能创建应用,只有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 点击下载 更新日期:20260417,支持的PHP版本:php7+(其他版本需自行测试)
    GO_SDK 点击下载 更新日期:20260418,支持的Go版本:Go 1.26+(其他版本需自行测试)
    python_SDK_点击下载 更新日期:20260424,支持的python版本:3.7 ~ 3.12
    修改于 2026-05-21 11:06:08
    上一页
    代码示例
    下一页
    查询闲鱼店铺
    Built with