小程序快速接入#

1. 小程序概述#

闲鱼小程序是可以在闲鱼App内运行的小程序。该小程序可以理解为能力增强，并且受到闲鱼平台管控的H5

注意：闲鱼小程序目前不对外公开开放申请，只面向闲鱼运营小二定向邀请的服务商，未经邀请的注册将不予通过。

2. 创建小程序#

2.1 创建淘宝企业账号#

这个账号是用来申请top平台的appKey的，后面开发小程序、调用top接口都需要用到这个appKey。

1. 打开淘宝企业账号注册，使用签约企业账号完成注册，这里需要同步创建支付宝账号，并完成支付宝实名认证。

2. 使用注册的企业账号登陆淘宝开放平台，完成实名认证，并且选择入驻身份。

注意：淘宝开放平台入驻主体 、闲鱼入驻主体、合同签约主体，这三者需要一致

2.2 入驻开放平台#

2.2.0 业务身份申请确认#

1、淘宝开放平台，选择开发创建应用，选择 阿里生态API开发 （如果没有这个选项，看第2步操作流程。如果已有该选项直接进行后续的appKey申请）

2、https://work.open.taobao.com/open-console-enter 入驻 应用软件开发商，会出现 阿里生态API开发 业务分类（如果已有其他业务身份导致不能申请应用软件开发商，先查看是否已经有 阿里生态API开发 分类，已有该分类则跳过此步，没有则查看是否有闲鱼开发者业务，入驻此业务身份）

2.2.1 小程序 AppKey 申请#

1. 创建应用 -> 选择 阿里生态API开发。(如果没有这个分类，请联系闲鱼技术同学)

   

2. 选择 闲鱼垂直行业-C端 确认类目。

   

3. 确认类目 -> 填写信息 -> 发起审批。

   • MRD和PRD可以上传对接的业务需求背景文档，其他三项可以先随便mock一下。
   

2.2.2 商家端 AppKey 申请#

注意：需要使用订单能力一定要申请这项，不使用订单则跳过这一步

1. 创建应用 -> 选择 阿里生态API开发。(如果没有这个分类，请联系闲鱼技术同学)

2.选择 闲鱼垂直行业-B端 确认类目。

3. 和小程序appKey一样，提交信息发起审批。

2.2.3 创建对应类目的应用#

1. 发起审批后，同步运营老师，让运营老师去推进审批流程。
2. 审批通过后，回到淘宝开发平台，找到对应审批记录。
3. 进入开发，创建对应类目下的应用。

2.2.4 闲鱼开放平台申请注册#

1. 打开闲鱼三方开放平台，首次进入需要登录，这里使用闲鱼账号登陆即可。
2. 登录闲鱼三方开放平台后，点击右上角「+申请注册」按钮。如下图所示，填写相关信息。

注意：请使用签约企业所有的闲鱼账号，切勿使用个人闲鱼账号，因为后续小程序相关的发布上线等操作都需要使用该账号完成。

• 淘宝nick：指的是淘宝账号名，不是邮箱。
• 小程序名称：需要注册的小程序名称，后续无法修改变更，谨慎。
• 申请业务说明：小程序的业务说明。

2.2.5 AppKey 回填（运营操作）#

1. 小程序appKey和商家端appKey（如果存在）应用创建后，服务商可在淘宝开放平台查询应用appKey，secret等：
   • 小程序appKey：在“阿里生态开放API”下，所在类目是“闲鱼垂直行业-C端”。
   • 商家端appKey：在“阿里生态开放API”下，所在类目是“闲鱼垂直行业-B端”。
2. 服务商将两个appkey同时群里同步给运营，运营进行后续的appKey回填。
3. 运营回填之后，服务商sdk里就可以获取到相应的API代码，闲鱼小程序初步创建完成了。

3. 开发小程序#

3.1 完善小程序信息#

appKey申请通过之后，进入闲鱼三方开放平台，点击右侧新建。 填写对应数据

❗ 基本信息注意项#

isv容器地址域名只能加白一些必要的第三方工具H5地址（非isv自己的页面比如fadada签约工具），其他的一律不允许填写！！！，如果要填写提前找闲鱼开发确认

3.2 申请API权限（申请此权限后，才能正常调通API）#

开发小程序之前，需要到管理平台上为对应小程序申请相关权限。点击对应小程序右方的「申请权限」按钮进入权限申请列表页

3.3 权限介绍#

点击申请权限，会进入到对应页面，小程序的权限分为两部分：

• TOPAPI：服务端相关的API
• WindvaneAPI：小程序调用的相关前端API

小程序开发者按照自身需求，按要求填写权限过期时间和使用说明，发起权限申请

❗ 权限包注意项#

目前普通的常规小程序只开放以下权限包供申请,（最小权限原则，按需要申请，不够可以后续再申请！！！）

TOPAPI (服务端)#

• userIsBindAccountQuery: TOP账号是否绑定支付宝查询
• userAgeQuery: TOP年龄信息查询
• userPhoneQuery: TOP用户手机号查询
• orderVirtualDelivery: TOP无物流虚拟发货
• userInfoQuery: TOP用户信息查询
• orderClose: TOP关闭订单-发货前
• refundQuery: TOP退款查询
• orderQuery: TOP订单查询
• partRefundBySeller: TOP部分退款
• refundBySellerAfterSendGoods: TOP全部退款-发货后退款
• orderCreateTopApi: TOP创建订单接口
• orderShip: TOP实物物流发货 (如果涉及实物物流发货，申请此接口，不需申请 orderVirtualDelivery)
• logisticsCompaniesQuery: TOP物流公司编码查询 (如果涉及实物物流发货，申请此接口，不需申请 orderVirtualDelivery)

WindvaneAPI (前端)#

• openSystem: 打开外部应用
• audio: 麦克风
• getPhoneNumber: 获取闲鱼用户的手机号
• saveImage: 保存图片到相册
• tradePay: Alipay付款
• clipboard: 剪切板
• deliveryAddress: 收货地址列表 (实物发货情况下申请这个)
• location: 地理位置
• photo: 相册

3.4 开发和调试#

因为闲鱼小程序其实是能力增强，受到平台管控的H5，所以开发小程序跟开发H5别无太大差别。
开发时会调用闲鱼小程序容器提供的API，所以需要手动引入JS-SDK：

https://o.alicdn.com/idleFish-F2e/miniapp-uni-api/index.js

这里需要注意几点：

1. 闲鱼小程序内部打开页面，直接使用window.location.href
2. 小程序内部支持hash和history模式
3. 小程序支持本地调试，具体参考「开发-开发调试」文档，里面有更详细的说明

3.5 订单交易流程#

可参考常见问题里的一些常见案例：常见问题文档

3.5.1 发布一个通用闲鱼商品#

服务商创建卖家闲鱼账号，发布一款通用商品，分享宝贝发布群内，告知闲鱼技术进行查询定位到商品ID，统一使用这一个商品ID进行拉起创单。

商品的详细说明参考：商品如何发布及订单里的商品概念

3.5.2 订单的交易链路#

交易链路参考：订单的交易链路

3.5.3 请求接口身份说明#

身份说明参考：API调用身份说明

3.6 环境检测脚本#

闲鱼需要对上架的小程序进行一定的管控，所有上架的小程序必须要通过script标签接入闲鱼的环境检测脚本，否则无法通过上架审核 脚本链接：

https://o.alicdn.com/moyu-project/mini-app-static-assets/checkEvn.js

3.7 AI一键搬家#

3.7.1 AI一键搬家流程说明#

如果现有业务已经有小程序上架过支付宝或者微信平台，可使用平台提供的「AI一键转换」将已有的小程序转换为闲鱼小程序

将源代码压缩成zip包，点击选择文件上传zip包，点击确认转换代码，平台将启动转换服务

转换完成后，在转换记录中可以查看转换报告，下载转换后的代码

3.7.2 同城服务小程序AI一键搬家#

目前针对同城服务业务的小程序，为保障在闲鱼平台的兼容性与运行稳定性，来自其他平台的代码（uni-app、后续增加其他原生小程序）需先通过AI转码完成初始化适配，完成后可正常调试与发布集成

在发布前，需要上传应用的最终源代码。平台将使用最终源代码与AI转码结果进行对比分析，用于持续优化转码质量，提升后续开发体验。

源码仅用于转码效果的统计分析，不会用于其他用途。

4. 发布小程序#

这里主要简单介绍发布主流程，详细介绍请参考「开发-发布集成」文档

当开发和测试完成后，点击对应小程序右方的「发布集成」按钮进入发布集成页面，创建变更。进入小程序正式发布流程。

4.1 创建变更#

进入发布集成页面，点击右侧的创建变更

打开变更创建页面：

字段说明

字段名	描述
小程序入口	填写当前小程序的入口链接（首页链接）
对接闲鱼运营	填写对接小二的花名或真实姓名，用于问题跟进时，方便联系
计划发布时间	选择预计发布上线的时间
是否为第一次变更	当选择为是时，需额外上传ICP备案文件
是否涉及订单功能	小程序里是否涉及订单相关功能，或调用订单相关API
变更内容	填写本次变更涉及的模块内容，可附带测试文档
变更包上传	上传zip格式的代码包
测试图片上传	按测试要求提供相关测试完成的截图
附件	体验预览包与测试图片一致即可；正式发布的包需要上传视觉图、说明文档
ipc备案	ipc备案材料，用于闲鱼法务审核

4.2 发布流程和节点说明#

变更提交后，可在列表及详情页查看目前变更所处流程节点