很多做二手回收、二手分销、多账号店群的企业,在自研或者改造二手 ERP 时,很容易混淆闲鱼官方能力,闲鱼本身没有直接对外开放原生 ERP 接口,商家经营类能力全部走闲管家开放平台完成对接,全网公开商品数据,则需要第三方数据接口做补充,两套接口分工完全不一样,混在一起开发会出现大量业务 bug。
简易技术实现思路
二手 ERP 对接闲鱼分为两大模块,店铺经营模块和外部货源采集模块。店铺经营模块,需要商家订购闲管家开放平台权限,创建自研进销存应用,拿到 AppKey、AppSecret,完成闲鱼账号授权,实现自有店铺商品、订单、物流双向打通,完成内部进销存闭环。外部货源采集模块,接入第三方标准化接口,做全网闲鱼商品搜索、详情读取,用于选品、估价、竞品巡检,这部分数据只能读,不能直接发布商品。整个系统开发要做好字段映射、消息回调、限流控制,区分开自有店铺操作和外部数据读取,不要尝试逆向抓包 APP 接口做生产环境使用,版本迭代就会失效。
闲管家开放平台(ERP 经营对接,管理自己的闲鱼店铺)
这是二手 ERP 操作自有闲鱼店铺的唯一正规通道,阿里原生并不直接开放闲鱼 API 给第三方 ERP,全部通过闲管家中间层转发,高级版没有开放接口权限,需要订购 ERP 专业版或者铂金版,才能开启开放平台能力。
核心接口能力覆盖二手 ERP 高频业务。商品模块,支持 ERP 内部商品批量发布到闲鱼、商品编辑、上下架、查询店铺在售商品列表,二手特有的成色、验货宝、个人闲置标识都可以传入,发布商品图片必须使用公网可访问图片链接,不能传本地图片地址。订单模块,定时拉取店铺订单,接收订单变更回调,获取买家地址、订单状态,处理退款售后单。物流模块,ERP 出库之后,回传快递单号,完成闲鱼平台发货操作。账号多店管理,一套应用可以管理当前闲管家账号下绑定的全部闲鱼店铺,多主体店铺建议分开账号创建应用隔离。
对接完整流程,首先注册闲管家账号,绑定需要运营的闲鱼鱼小铺账号,订购对应开放平台版本。进入开放平台,选择我有自研系统,创建进销存类型应用,生成 AppKey 和 AppSecret,配置服务器 IP 白名单,填写消息回调地址用来接收订单、商品状态变更推送,应用设置上线之后接口才可以调用。二手 ERP 侧编写签名逻辑,按照文档签名规则发起 http 请求,完成商品、订单、物流接口调试。ERP 系统完成字段映射,把 ERP 内部 SKU、库存、二手成色字段和闲管家接口字段一一对应,做联调测试,跑通发布商品、下单、出库回传单号完整业务链路,上线正式环境。
接口调用限制,默认 QPS 为 10 每秒,业务量大可以额外订购扩容,接口返回错误码需要做好重试机制,订单、商品变更优先使用回调推送,减少轮询拉取带来的请求压力。
第三方数据接口(货源采集、行情分析,只读外部全网商品)
这套接口只做数据读取,不能操作自己的闲鱼店铺,主要服务二手 ERP 的货源选品、回收估价、竞品监控场景,和闲管家经营接口互相配合。
可以实现的业务能力,关键词搜索闲鱼全平台商品,筛选价格、成色、地区,批量获取商品基础信息。单品详情查询,拿到二手商品原价、描述、图片、卖家信用、验货宝状态,给到回收业务做估价参考。卖家店铺商品列表,批量读取同行卖家全部在售货品,做货源盘点。
真实业务场景,二手回收 ERP,定时调用搜索接口扫描目标类目货源,筛选符合回收条件的商品,拉取详情做估价,把外部货源数据导入 ERP 选品库。品牌二手商家 ERP,定时巡检全网低价窜货商品,留存商品信息用于维权取证。二手分销 ERP,一边通过闲管家接口管理自家店铺铺货发货,一边调用第三方接口采集全网货源做选品池。
二手 ERP 完整业务闭环架构
ERP 仓储库存模块,内部维护二手货品 SN 序列号、成色、成本价。对外两个数据通道,闲管家开放平台负责输出,把库存商品发布闲鱼,接收闲鱼订单,订单触发 ERP 出库,出库完成回传物流单号。第三方数据接口负责输入,采集全网二手货源进入 ERP 选品库,用于采购、回收估价。业务层做数据隔离,外部采集到的商品数据,不能直接调用闲管家接口无脑铺货,需要经过人工或者业务规则过滤,规避违规、侵权风险。
高频踩坑点与风险提示
第一,不要混淆两套接口,闲管家只能管理自己授权的店铺,不能读取全网别人的商品;第三方接口只能读数据,不能发布、处理自家店铺订单,很多开发者直接拿第三方接口试图做店铺发货,会完全行不通。
第二,闲管家发布商品有闲鱼平台本身的发布数量限制,普通账号、鱼小铺有商品上限,超量需要购买闲鱼运营提效包,接口调用成功不代表闲鱼 APP 一定展示商品,要查看返回的业务错误信息。
第三,二手商品属性复杂,成色、是否验货宝、个人闲置 / 商家货,字段映射出错,会出现发布之后商品异常下架。
第四,遵守数据合规,第三方接口拿到的用户信息,只用于业务分析,禁止存储、泄露买家卖家隐私信息。
第五,不建议使用抓包逆向闲鱼 APP 接口,APP 加密频繁更新,线上生产环境随时失效,同时会带来账号风控封禁风险。