新浪SEA开放平台开发文档 / 轻应用接入指南

轻应用接入指南

接入流程

97580f43jw1eu2gm5g4r5j20gi01pq2t.jpg

简介

什么是轻应用?

轻应用是微博为第三方服务(H5页面)接入微博提供的一套基础框架和接入服务(Focus On Mobile)。

轻应用入口在微博 Page 页(也叫 Profile 页、个人主页),或者微博的卡片(Card)中,由接入方以网页应用的形式开发。


根据展示平台,轻应用分为两种:桌面浏览器上通过 iframe 嵌入(以下简称 Web 版),微博客户端内通过 Webview 展示(以下简称 H5 版)。你的应用可以选择两种展示平台之一,也可以二者都支持。

特点

轻应用提供符合微博平台属性的更多接近用户的渠道,促进用户与商家双向关系的形成,让用户更有效发现并使用服务。


  • 接入便捷。接入方 H5 网页只需针对微博做少量的兼容工作,就能享受官方客户端提供的一系统轻应用服务,从而为用户提供更好的体验
  • 无需授权。如果用户在登录状态访问应用,新的框架将默认完成授权,并将 access_token 信息传递给接入方。
  • 更多的曝光机会。应用上线后会出现在 Page 页,以及微博 Feed 流的 card 中。支持 linkcard 接入,在微博中得到更好的展示。
  • • 开发过程,统一了接入方式和参数。无论是 Web 版还是 H5 版,客户端收到的参数都是相同的,接入方式也基本上都相同。应用可以通过浏览器 userAgent 来区分是 Web 版还是 H5 版。
  • 支持接入微博支付,一键完成商品支付。
  • • [Web 版]新增应用分享和赞。直接将应用分享到微博,并生成卡片展示,快速传播。
  • • [Web 版]支持未登录访问应用。未登录微博也可以浏览应用,必要的时候通过我们的 JS 客户端唤起登录浮层。
  • • [Web 版]应用宽度调整为 940 px。不支持原来的 760px,原来的 950 px 改为 940px。

轻应用场景

有的轻应用,更加突出的是内页,如电影、图书,可能您希望在微博流中直接看到一个卡片,点击卡片就能直接进入到商品详情页直接购买;

有的应用更突出应用首页,比如网页游戏、单页应用,它们入口唯一,点开应用首页进去就能玩;

或者二者兼而有之,都是可以的。


应用范例

网上4S店(Web & H5版 均接入):

pageapp4s221.png

pageapp4smobile221.png

H5 版本:

友宝、爱影客


更多轻应用的介绍,请点击这里。

轻应用开发流程

轻应用的开发大致分为四个步骤:

  • • 成为微博开发者
  • • 应用创建
  • • 应用开发
  • • 应用审核及上线


如下图所示:

workflow.png

加入微博开发者

开发 轻应用的第一步,是成为微博公司开发者。

如果您还不是微博开发者,请先登录微博开放平台,然后进入管理中心完善开发者基本信息和身份认证。


基本信息部分,直接选择开发者类型为公司,完成表单。填写完成后,通过邮箱验证就可以开始创建应用了。

baseinfo.png


通过身份认证,有利于应用的审核和各种权限的申请,请一并认真填写。

id-verify.png

个人开发者升级为公司开发者

如果已经是个人开发者,需要进入编辑开发者信息页面,重新选择开发者类型为公司,然后保存资料即可。

应用创建

在 轻应用介绍页,点击创建应用按钮,进入创建表单填写页面。


8aafa3b9jw1ejguyf0gjjj20og0d33zh.jpg


完成表单填写,会自动跳转到应用的控制台,在应用控制台可以进一步完善应用的基本信息。

编辑应用信息

打开应用信息->基本信息,可以查看应用的基本数据。点击编辑,可以进行修改。

测试地址(Web版、H5版)

打开应用信息->测试信息,可以看到应用的测试地址。因为应用还没通过审核并上线到应用广场,这个地址仅限开发者本人浏览访问。

如果需要其他微博用户浏览,可以将该微博用户添加到测试帐号里。每个应用测试帐号最多添加 15 人。


test-address.png

应用通过文案审核并上广场后,测试帐号自动失效。


升级为轻应用

升级主要指的是原来已经成功创建了的企业应用、站内应用或个人版 Page 应用,升级为轻应用。

由于已经创建了应用的 appkey,升级主要包含两个方面:一是微博开放平台后台将 appkey 升级为轻应用类型;二是应用将原来接收的旧参数改为新的参数。