小程序快速接入#

1. 小程序概述#

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

2. 创建小程序#

2.1 创建淘宝企业账号#

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

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

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

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

2.2 入驻开放平台#

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

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

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

填写完成后点击确定即可。

2. 申请注册小程序完成后，联系对接的闲鱼运营同学，让其发起内部审核流程。
   1. 闲鱼运营同学会在ISV安全管理平台上，找到小程序注册的相关信息。
   2. 根据淘宝nick和业务说明，发起淘宝开放平台appKey的申请。
   3. 审批流程完成后，应用自动创建。开发者去淘宝开放平台查询应用appKey，secret等（注意应用是在“其他”tab下，所在类目是“新业务”）。
   4. 开发者将查询到的appKey提供给闲鱼运营同学，然后在ISV安全管理平台上填入申请好的appKey，完成创建。

走完上述流程，闲鱼小程序初步创建完成了。

2.3 完善小程序信息#

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

3. 开发小程序#

3.1 申请API权限#

开发小程序之前，需要到管理平台上为对应小程序申请相关权限。点击对应小程序右方的「申请权限」按钮进入发布集成页面，创建变更

3.2 权限介绍#

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

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

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

3.3 开发和调试#

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

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

这里需要注意几点：

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

4. 发布小程序#

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

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

4.1 创建变更#

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

打开变更创建页面：

字段说明

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

4.2 发布流程和节点说明#

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