闲鱼开放平台

闲鱼开放平台

专用API
【更新时间: 2024.07.29】 闲鱼开放平台是阿里巴巴集团旗下闲鱼项目的开放接口平台，专为开发者提供全面的技术支持和服务。该平台通过开放API接口，帮助开发者快速集成闲鱼的多种功能
浏览次数
1.2K
采购人数
1
试用次数
1
! SLA: N/A
! 响应: N/A
! 适用于个人&企业
试用
收藏
×
完成
取消
×
书签名称
确定
<
产品介绍
>

什么是闲鱼开放平台?

通过该平台，开发者可以接入闲鱼的各种服务和数据，从而实现二手交易、物品发布、用户管理等多种功能。这不仅提升了开发者的开发效率，也增强了与闲鱼的生态连接，使得用户能够在闲鱼上进行更丰富多样的操作。

什么是闲鱼开放平台接口？

由服务使用方的应用程序发起，以Restful风格为主、通过公网HTTP协议调用闲鱼开放平台，从而实现程序的自动化交互，提高服务效率。

闲鱼开放平台有哪些核心功能？

  1. 订单创建：服务商可以通过TOP接口调用创单API创建闲鱼订单
  2. 发货接口-虚拟发货：该接口适用于无需物流发货的场景。对应创单时不需要传入deliver_id的情况。
  3. 发货接口-有物流发货：有实物物流的发货场景，对应创单时需要传入deliver_id的情况
  4. 物流公司编码查询（lc_code）
  5. 逆向订单查询
  6. 正向订单查询
  7. 退款单处理
  8. 服务商主动取消订单（未发货）
  9. 正向订单变更消息
  10. 逆向订单变更消息
  11. 用户基础信息（性别、头像、昵称）

闲鱼开放平台的核心优势是什么？

 

  1. 丰富的功能接口：闲鱼开放平台提供了多种接口，覆盖商品管理、订单处理、用户管理等各个方面，满足开发者的多样化需求。
  2. 高效的开发支持：平台提供详细的开发文档和技术支持，帮助开发者快速上手并高效完成开发任务。
  3. 稳定的系统性能：作为阿里巴巴旗下产品，闲鱼开放平台拥有强大的技术底蕴和稳定的系统性能，确保开发者在使用过程中能够获得良好的体验。

 

在哪些场景会用到闲鱼开放平台？

电商平台的二手商品专区：一个大型电商平台想要增加一个二手商品交易专区，可以通过闲鱼开放平台的接口，将商品发布、订单管理等功能接入到自己的平台中，从而为用户提供一个可靠的二手商品交易服务。

 

 
社交媒体的二手交易功能：一个社交媒体平台希望增加用户互动的多样性，决定增加二手交易功能。通过闲鱼开放平台的用户管理和商品发布接口，可以让用户在社交平台上直接发布和管理自己的二手商品，增强平台的用户粘性。

 
 

 

 
<
使用指南
>

1. 环境准备-聚石塔接入

由于集团安全规则，需接入聚石塔后进行调用，用户id、订单信息等必须存储在聚石塔内的数据库中，因此需要将服务端的服务均部署在聚石塔内。

相关文档：聚石塔-入塔指南

聚石塔外是可以访问塔内。聚石塔内如果需要访问塔外，需要走审批。 参考文档： 奇门自定义API场景接入流程

2. 用户登录授权

授权登录是采⽤淘宝开放平台auth2.0⽅式进⾏的，前端的主要⼯作是获取授权码（code），由服务器端通过code 和应用密钥（AppSecret）调用taobao.top.auth.token.create这个top接口换取accessToken、token的过期时间和⽤户uid等信息。该accessToken可以用来后续请求TOP接口。

目前新接入的小程序，可以直接使用客户端API用户授权，直接获取授权码（code），不需要跳转到回调地址。

注意：授权码（code）仅能使⽤⼀次，如果已经使⽤则需要重新获取。

另外，在accessToken过期之前，不需要重新获取授权码。因此在第一次登录授权后，小程序可以生成自己的cookie，缓存在客户端内（闲鱼提供了setStorage和getStorage两个API）。避免同一用户每次进入小程序都重新获取code，否则可能会被限流。

整体流程如下：

image

注意： 1.授权码（code）仅能使⽤⼀次，如果已经使⽤则需要重新获取。

【接口】：taobao.top.auth.token.create

【入参】：

字段 类型 介绍
code String 授权code，前端组件获取到的code

详情参考：https://open.goofish.com/doc/development/dev/server.html#1-%E7%8E%AF%E5%A2%83%E5%87%86%E5%A4%87-%E8%81%9A%E7%9F%B3%E5%A1%94%E6%8E%A5%E5%85%A5

 

<
产品问答
>
?
初次接入小程序，需要申请哪些权限?
权限分为客户端接口权限和服务端接口权限，需要在管理平台上申请权限后才能使用。具体可以参考【小程序快速接入】申请API权限
?
小程序对浏览器API支持是否完整；在SPA应用下，是否支持History模式？
都支持的。闲鱼小程序可以理解为一个能力增强，但是被平台管控受限的H5。都支持的。闲鱼小程序可以理解为一个能力增强，但是被平台管控受限的H5。
?
入驻闲鱼小程序，必须要部署“聚石塔服务”吗？
是的。闲鱼小程序调用的后端接口，都必须部署到聚石塔上。
?
聚石塔如何接入？
参考文档：https://open.taobao.com/docV3.htm?docId=982&docType=1&source=search#s2参考文档：https://open.taobao.com/docV3.htm?docId=982&docType=1&source=search#s2
?
部署到聚石塔的接口可以调用外部接口吗？
可以。聚石塔内外互通是通过奇门接口实现的。具体可以参考：聚石塔内外互通说明。
?
小程序内使用的闲鱼账号和淘宝开发者账号，可以用个人账号吗？如果是用个人账号，后期还能再变更为公司账户...
为保障整体业务流畅，请使用与闲鱼签约的企业账号申请闲鱼账号和淘宝开发者账号；如果使用个人账号，后期不支持变更，所以推荐使用企业账号。理论上淘宝开放平台入驻主体 、闲鱼入驻主体、合同签约主体，三者应该一致。为保障整体业务流畅，请使用与闲鱼签约的企业账号申请闲鱼账号和淘宝开发者账号；如果使用个人账号，后期不支持变更，所以推荐使用企业账号。理论上淘宝开放平台入驻主体 、闲鱼入驻主体、合同签约主体，三者应该一致。
<
关于我们
>
浙江阿里巴巴闲鱼网络科技有限公司
企业
闲鱼是中国领先的二手交易平台，隶属于阿里巴巴集团，致力于为用户提供安全、便捷的二手商品交易服务。用户可以通过闲鱼发布、购买和交换二手商品，同时享受专业的售后保障和社区互动功能。闲鱼开放平台提供丰富的API接口，支持小程序开发者快速接入和发布集成，为广大开发者提供了便利的技术支持和文档指导。
联系信息
服务时间： 00:00:00至24:00:00
网页在线客服： 咨询
API接口列表
<
使用指南
>

1. 环境准备-聚石塔接入

由于集团安全规则，需接入聚石塔后进行调用，用户id、订单信息等必须存储在聚石塔内的数据库中，因此需要将服务端的服务均部署在聚石塔内。

相关文档：聚石塔-入塔指南

聚石塔外是可以访问塔内。聚石塔内如果需要访问塔外，需要走审批。 参考文档： 奇门自定义API场景接入流程

2. 用户登录授权

授权登录是采⽤淘宝开放平台auth2.0⽅式进⾏的，前端的主要⼯作是获取授权码（code），由服务器端通过code 和应用密钥（AppSecret）调用taobao.top.auth.token.create这个top接口换取accessToken、token的过期时间和⽤户uid等信息。该accessToken可以用来后续请求TOP接口。

目前新接入的小程序，可以直接使用客户端API用户授权，直接获取授权码（code），不需要跳转到回调地址。

注意：授权码（code）仅能使⽤⼀次，如果已经使⽤则需要重新获取。

另外，在accessToken过期之前，不需要重新获取授权码。因此在第一次登录授权后，小程序可以生成自己的cookie，缓存在客户端内（闲鱼提供了setStorage和getStorage两个API）。避免同一用户每次进入小程序都重新获取code，否则可能会被限流。

整体流程如下：

image

注意： 1.授权码（code）仅能使⽤⼀次，如果已经使⽤则需要重新获取。

【接口】：taobao.top.auth.token.create

【入参】：

字段 类型 介绍
code String 授权code，前端组件获取到的code

详情参考：https://open.goofish.com/doc/development/dev/server.html#1-%E7%8E%AF%E5%A2%83%E5%87%86%E5%A4%87-%E8%81%9A%E7%9F%B3%E5%A1%94%E6%8E%A5%E5%85%A5

 

<
依赖服务
>
<
产品问答
>
?
初次接入小程序，需要申请哪些权限?
权限分为客户端接口权限和服务端接口权限，需要在管理平台上申请权限后才能使用。具体可以参考【小程序快速接入】申请API权限
?
小程序对浏览器API支持是否完整；在SPA应用下，是否支持History模式？
都支持的。闲鱼小程序可以理解为一个能力增强，但是被平台管控受限的H5。都支持的。闲鱼小程序可以理解为一个能力增强，但是被平台管控受限的H5。
?
入驻闲鱼小程序，必须要部署“聚石塔服务”吗？
是的。闲鱼小程序调用的后端接口，都必须部署到聚石塔上。
?
聚石塔如何接入？
参考文档：https://open.taobao.com/docV3.htm?docId=982&docType=1&source=search#s2参考文档：https://open.taobao.com/docV3.htm?docId=982&docType=1&source=search#s2
?
部署到聚石塔的接口可以调用外部接口吗？
可以。聚石塔内外互通是通过奇门接口实现的。具体可以参考：聚石塔内外互通说明。
?
小程序内使用的闲鱼账号和淘宝开发者账号，可以用个人账号吗？如果是用个人账号，后期还能再变更为公司账户...
为保障整体业务流畅，请使用与闲鱼签约的企业账号申请闲鱼账号和淘宝开发者账号；如果使用个人账号，后期不支持变更，所以推荐使用企业账号。理论上淘宝开放平台入驻主体 、闲鱼入驻主体、合同签约主体，三者应该一致。为保障整体业务流畅，请使用与闲鱼签约的企业账号申请闲鱼账号和淘宝开发者账号；如果使用个人账号，后期不支持变更，所以推荐使用企业账号。理论上淘宝开放平台入驻主体 、闲鱼入驻主体、合同签约主体，三者应该一致。
<
关于我们
>
浙江阿里巴巴闲鱼网络科技有限公司
企业
闲鱼是中国领先的二手交易平台，隶属于阿里巴巴集团，致力于为用户提供安全、便捷的二手商品交易服务。用户可以通过闲鱼发布、购买和交换二手商品，同时享受专业的售后保障和社区互动功能。闲鱼开放平台提供丰富的API接口，支持小程序开发者快速接入和发布集成，为广大开发者提供了便利的技术支持和文档指导。
联系信息
服务时间： 00:00:00至24:00:00
网页在线客服： 咨询