1 概述 该手册旨在帮助服务商更快接入百度小程序第三方平台,并代开发者开发、运营百度智能小程序。
2 名词解释与缩写 3 服务商入驻 3.1 服务商入驻 3.1.1 申请入驻 1)前往并登录百度智能小程序官网 支持账号:百家号、熊掌号等非个人类型百度账号;百度推广、百青藤等百度商业账号 2)登录成功后,前往“第三方平台”主页 3)第三方平台主页内,点击“立即申请”按钮申请入驻第三方平台 4)填写企业名称,提交服务商资质审核 请确保填写的企业名称与营业执照相符,否则会影响第三方平台权限开通。 若您的账号已入驻智能小程序,并完成过主体认证,则入驻第三方平台时会自动复用该主体资质,仅需确认信息即可。 5)百度审核服务商企业资质 提交企业名称后,百度会对服务商企业资质进行机审,判断是否满足第三方平台开通资格。该审核结果可即时反馈。
3.1.2 主体认证 通过服务商资质审核后,将自动跳转至主体认证流程。若账号已在智能小程序完成过主体认证,则可跳过该步骤。 1)选择主体类型 请选择业务相关对应主体类型,该类型在注册成功后不可更改。 2)填写主体信息 按照要求填写并上传主体资质信息,请确保信息真实有效。 注:主体认证环节最多5次提交机会,请仔细核对信息并填写完成! 3)百度审核主体资质 信息提交成功后,百度将在2-5个工作日内完成审核。
3.1.3 真实性认证 完成主体认证后,需进一步完成真实性认证,否则第三方平台将无法上线。 1)进入认证中心 2)完成认证 不同主体类型可选的认证方式不同,具体如下: 方式1:对公验证 方式2:证照验证 方式3:法人人脸识别验证 3.2 平台创建与发布 3.2.1 第三方平台创建 您可在登录服务商超级管理员账号后,前往管理中心/第三方平台,创建一个第三方平台应用。(注:同一账号最多可创建5个第三方平台应用) 1)填写基本信息 填写您的第三方平台基本信息,该信息将展示在用户授权页面。其中官方网站需填写您的主体在工信部完成备案的网址。 2)选择权限 选择您的平台所需获取的用户权限,选中后该权限将展示在用户授权页面中,并可被用户选择。 3)填写开发资料 填写开发相关信息,请仔细阅读,具体如下: - 授权发起页域名:指小程序在登录授权给第三方平台时的授权回调域名,在用户扫码授权流程中,同时必须从本域名内网页跳转到登录授权页,才可完成登录授权。
- 授权测试名单:第三方平台全网发布前,仅该列表内的小程序才可进行授权,以便测试。(获取APPID在开发者后台→设置→开发设置)
- 授权接收URL :用于接收授权成功、更新、解除通知,也用于接收ticket。ticket是验证平台方的重要凭据,在获取第三方平台access_token时需要提供最新推送的ticket以供验证身份合法性。此ticket作为验证平台方的重要凭据,请妥善保存。
- 消息验证TOKEN:第三方平台在代替小程序接收消息时,用此Token来校验消息。
- 消息加解密Key:在代替小程序收发消息过程中使用。
- 消息与事件接收URL:该URL用于接收已授权小程序的消息和事件。
- 服务域名:服务器域名。
- 业务域名:小程序内H5跳转域名限制规则,业务域名需要经过ICP备案。
- 白名单IP地址列表:仅当第三方平台IP地址在该列表中时,才被允许调用相关接口。当不填写时,默认不进行IP校验。
该步骤完成后平台即创建成功,可开始进行平台功能开发。
3.2.2 第三方平台开发 请开发勾选权限集对应的产品能力,测试小程序请添加至测试白名单,可在平台发布前完成授权。 百度将在平台发布前对功能实现进行自动化检测,通过后才可发布平台,并接受开发者授权。
3.2.3 第三方平台发布 1)平台能力检测 在第三方平台创建成功并最终开发测试完毕后,可提交全网发布申请。此时,百度服务器会通过自动化测试的方式,检测第三方平台所勾选权限集对应服务的基础逻辑是否可用。在通过检测后,才会允许第三方平台提交全网发布。 2)平台基本信息审核 通过平台能力检测后,百度将对平台基本信息进行审核,审核通过后第三方平台即完成发布上线。
4 代开发业务实现 4.1 小程序开发 第三方平台为已授权的小程序提交代码时有两种方式: - 模板开发。先开发小程序模板,再用模板给授权小程序上传代码。
- 定制开发。使用开发者工具直接为授权的小程序提交源代码。
4.1.1 模板开发 第一步:绑定开发小程序 2)在第三方平台-设置-绑定开发小程序页面中,使用该小程序管理员账号登录百度APP并扫描二维码,将该小程序绑定为模板开发小程序。
第二步:开发并上传小程序模板草稿 1)使用绑定开发小程序的管理员或成员账号登录百度小程序开发者工具(IDE)。 2)开发者工具中按照正常的小程序开发流程进行代码开发和调试。 3)开发完成后,点击发布,完成草稿上传。 注意:上传草稿时,小程序根目录下请不要包含ext.json文件,否则无法上传成功
第三步:添加小程序草稿至模板库,获取模板ID 从开发者工具中上传的代码,会先存在草稿箱中,开发者可在第三方平台操作或调用接口将草稿箱中的草稿添加到小程序模板库中,小程序模板库中的模板不会被覆盖。每个第三方平台最多可以有五十个代码模板,添加后可以获得模板ID。 第四步:开发者将小程序授权第三方平台
第五步:调用接口为授权小程序提交代码包
4.1.2 定制开发 第一步:开发者将小程序授权第三方平台
第二步:开发并上传小程序源代码包 使用绑定开发小程序的开发者账号登录百度小程序开发者工具(IDE),并在开发者工具中按照正常的小程序开发流程进行代码开发和调试。开发完成后,在小程序包中增加ext.json文件,并在文件中增加extAppid字段(该appId请填写待提包的客户授权小程序id),点击发布即可完成授权小程序代码包提交。
4.2 代注册(白名单开放) 代注册功能支持服务商代授权开发者注册百度小程序账号,并创建小程序,可实现小程序生命周期全流程托管。
4.2.1 授权 服务商可通过接口获取代注册授权二维码,并引导开发者使用百度APP扫描二维码进行服务商授权。具体授权流程交互如下: 1)使用百度APP扫描授权二维码 2)确认登录百度账号或百度商业账号(注:账号需绑定手机号) 3)当账号已绑定百家号或熊掌ID时,需确认直接复用已有账号资质开通小程序账号;若未绑定则无需此步骤 4)确认授权服务商及相应权限 5)授权成功,服务商可通过页面回调及推送获得授权凭证(账号未注册时获得代注册授权码/代创建授权码,账号已注册时仅获得代创建授权码) 注意:重新扫描代注册授权二维码可解除
4.2.2 代注册账号 开发者完成授权后,服务商可通过接口代开发者提交账号信息及小程序信息。在账号通过审核后,百度会自动创建一个小程序,将小程序信息提交审核,并同时推送服务商代注册成功结果。而小程序基本信息则会在人审结束(24小时内)后,单独进行结果推送(该阶段会审核小程序名称及特殊行业类目资质,推送也会覆盖该两项)。 若在提交代注册请求时遇到小程序名称重复、参数错误等问题,或账号审核失败,请修改相关信息后重新调用代注册接口进行提交。当账号审核通过且小程序创建成功后,代注册授权码即失效,若需在该账号下继续创建多个小程序请调用代创建小程序接口。
4.2.3 代创建小程序 当授权账号注册已完成时,服务商可调用代创建小程序接口在该账号下创建一个新的小程序,并提交小程序基本信息。在调用成功后,百度会创建一个小程序,将小程序信息提交审核,并同时推送服务商代创建成功结果。小程序基本信息则会在人审结束(24小时内)后,单独进行结果推送(该阶段会审核小程序名称及特殊行业类目资质,推送也会覆盖该两项)。 注意:每个小程序账号下默认可创建20个小程序,达到上限后则无法继续创建。
4.3 代认证 小程序上线前,要求必须完成主体真实性认证。目前,针对不同主体类型,主体真实性认证方式如下: 其中服务商可通过API快速调起对公验证或法人人脸识别验证服务页面,使得开发者无需前往百度后台即可完成认证操作。
4.3.1 对公验证 服务商可通过API调起对公验证页面,并由开发者在该页面完成认证操作,具体接口文档可参考 : 对公验证操作流程如下: 1)开发者前往对公验证页面,完善对公账户信息 2)百度向开发者对公账户打款 3)开发者查询对公账户接收到的打款金额,并前往对公验证页面回填金额 金额验证通过后,即可完成主体真实性认证。
4.3.2 法人人脸识别验证 服务商可通过API获取法人人脸识别二维码,开发者法人可通过百度APP扫描该二维码进入法人人脸识别验证页面,完善信息并刷脸验证后即可完成主体真实性认证,具体接口文档可参考: 注意:针对企业类型主体,百度后台仅支持对公验证方式,而服务商接口则支持对公验证和法人人脸识别验证两种方式。
4.4 小程序生命周期管理 服务商可通过接口代授权小程序管理基础、开发信息,提交代码包并发布上线,实现小程序全生命周期的管理。
4.4.1 小程序授权 当开发者在智能小程序开发者平台完成账号注册、小程序创建后,可通过百度APP扫描服务商授权二维码,将账号下小程序授权给服务商。 1)开发者账号注册 开发者可前往百度小程序官网,提交企业信息及运营者信息以注册小程序账号并进行主体认证,具体可参考文档: 2)开发者创建小程序 账号注册完成并通过主体认证后,开发者可前往百度小程序管理中心,创建一个智能小程序并完善小程序基本信息,具体可参考文档: 3)开发者扫码授权 小程序创建完成后,开发者可前往服务商平台,扫描授权二维码将账户下小程序授权给服务商代为管理。 服务商调用百度API获取授权二维码可参考文档: 开发者扫描二维码后,将跳转进入授权页,依次完成账号确认、授权小程序选择、授权权限确认等操作后,即可将小程序授权给服务商。服务商可继续通过API获取授权小程序接口调用凭证,并代其开发管理小程序。
4.4.2 开发信息设置 在服务商代授权小程序开发时,需调用百度API完成以下开发信息设置: 1)设置小程序服务器域名,可参考文档: 2)设置小程序业务域名,添加业务域名后可打开对应域名下的webview页面,可参考文档: 注意:需先将业务域名添加至TP开放平台并通过域名校验,才能进一步将该业务域名配置给小程序
4.4.3 修改基本信息 当开发者小程序的基本信息未过审,或需要进行修改时,服务商可调用修改基本信息的API代开发者进行操作。基本信息修改提交成功后,百度将会进行审核(24小时),并在审核结束后将审核结果推送至服务商的消息与事件接收URL。 注意: 1)提交行业类目修改时,可先通过API查询全部行业类目对应ID; 2)基本信息的修改有次数限制,具体如下: 服务商可通过调用API查询剩余修改次数,具体可参考:
4.4.4 上传代码包 服务商可通过模板或源代码提包两种方式,为授权小程序账号提交代码包。 1)通过API实现模板提包,具体可参考: 注意:需要先将模板上传至第三方平台,才能使用该模板代开发者提交代码包。 2)通过开发者工具提交原代码包,具体可参考:
4.4.5 提交代码包审核 代码包上传成功后,需进一步将代码包送审,审核通过后才能发布上线。提交代码包审核有两种方式,具体如下: 1)调用API为代码包提审,具体可参考文档: 2)调用模板提包API时,通过ext_json中的directCommit字段设置直接送审,具体可参考:
4.4.6 发布上线 服务商可通过调用API为授权小程序提交发布,发布成功后即可在百度APP搜索引擎及小程序中心展示小程序,具体可参考: 注意:小程序发布上线前需先完成以下三个步骤 1) 通过主体真实性认证 2) 小程序基本信息全部通过审核 3) 小程序代码包通过审核 全部完成后,小程序才能正式发布上线。
4.4.7 巡检下线 线上小程序会不定期接受巡检,若巡检中发现小程序问题则会进行强制下线、流量下线、限时整改处理,需要服务商代开发者按要求修改后再恢复上线。授权小程序被巡检处理时,百度会向服务器发送推送,具体可参考: 具体处理措施及解决方案如下: 1)强制下线 小程序被强制下线后,包体会处于下线状态,不再能被流量分发。强制下线类型可分为三类:基本信息问题下线、包体问题下线、基本信息和包体都有问题而下线。 - 当包体有问题而下线时,可修改代码包后重新提包,审核通过后调用发布上线接口即恢复上线
- 当基本信息和包体均有问题时,需调用API修改基本信息,同时再修改代码包并提交审核,两者均通过后调用发布上线接口即可恢复上线
2)流量下线 小程序被流量下线后,包体仍处于上线状态,但不再能被流量分发。流量下线类型也分为三类:基本信息问题下线、包体问题下线、基本信息和包体都有问题而下线。 - 基本信息问题下流量时,可直接调用修改名称、头像、类目、简介API(非强制下线修改基本信息API)修改小程序基本信息,通过后即可恢复上线;
- 包体问题下流量时,可直接修改并提交代码包,过审后即可恢复流量;此外,若因包体问题下线,但实际无需修改包体,可直接热更新内容完成修改时,可调用申请恢复流量下线接口(http://smartprogram.baidu.com/docs/third/info)提交复审,审核通过后自动恢复流量
- 基本信息和包体均有问题时,需修改基本信息并重新提交代码包,两者均过审后即可恢复流量
3)限时整改 小程序被限时整改后,包体仍处于上线状态,流量也无影响,但开发者需要在3天内完成修改,否则会将小程序强制下线。 流量下线类型也分为三类:基本信息问题下线、包体问题下线、基本信息和包体都有问题而下线。 - 基本信息有问题时,可直接调用修改名称、头像、类目、简介API(非强制下线修改基本信息API)修改小程序基本信息,通过审核后即可完成整改;
- 包体有问题时,可直接修改并提交代码包,过审后即可完成整改
- 基本信息和包体均有问题时,需修改基本信息并重新提交代码包,两者均过审后即可完成整改
5 高级能力实现 5.1 支付能力 百度智能小程序接入支付能力需要使用百度聚合收银台,并开通支付账户及服务。服务商可调用接口代开发者申请支付账号并开通支付服务,具体步骤如下: 1)代创建支付账号 2)提交开发者信息设置 3)创建支付服务 注意:TP开放平台有支付管理专属权限集,开发者授权该权限集后,服务商才能调用相关接口代为创建支付服务。 开通支付服务后,服务商可通过百度聚合收银台实现支付业务,具体可参考文档:
5.2 客服能力 5.2.1 接入客服方式 目前,开发者可通过三种方式接入客服能力: 1.客服消息转发:通过服务器接收、转发客服消息,支持服务商服务器代收发消息 2.绑定百度商桥客服工具,可前往开发者平台配置,文档参考: 3.配置第三方客服工具,可前往开发者平台配置,文档参考: 其中,针对方案1,开发者将客服权限授权给服务商后,客服消息将直接推送至服务商服务器。
5.2.2 服务商代管理客服消息转发 1)客服消息入口: 开发者在小程序内添加客服功能(参考在在页面中使用客服消息)后,用户可在小程序内唤起客服会话页面,给小程序发消息; 已使用过的小程序客服消息会聚合显示在“百度APP-我的-私信”中,用户可以在此处查看历史客服消息,并给小程序客服发消息。 2)消息下发条件: 当用户向小程序客服发送消息后,48小时内,小程序客服最多可以向开发者发送5条消息,可发送客服消息条数不累加,上述用户动作会触发可下发条数及可下发时限的更新,可下发消息条数更新为当前可下发条数限制的最大值,有效下发时间限制也更新为最长有效时间。 3)消息支持的类型 目前支持文本及图片类型消息。 4)客服消息转发原理 在开发者将客服权限授权给服务商后,服务商可以代为接收并回复小程序的客服消息。 当用户给小程序(已授权客服权限)客服发消息时,百度的服务器会将消息的数据包(JSON或者XML格式)POST到服务商的消息与事件接收URL。服务商收到客服消息后,需自行展示给客户的客服人员,并在客服回复消息后,调用接口将该消息异步回复给百度。 5)开发客服消息转发能力
|