新浪微博JS SDK API的使用

❗️ 注意：离本文创建时间已经过去了天，请注意时效性

前言

以前整个网站都是老大一个人怼起来的,各种 bug 和各种细节不完善.所以打算重构一下,侯哥搭好了seajs的开发框架,因此我只需要写前端逻辑即可.

现状

注册和登陆部分是我写的,因此我打算增加个新浪微博和 QQ 登陆的功能,用户点击之后存储其 id 到数据库,当然这个需要修改数据库表字段,单独增加一个类似于wb_id的字段名来标示.

现在流行的做法有两种,一个是用新浪微博(或其他登录方式,下同)登陆之后,后台自动创建一个 id 作为本站唯一的标示,同一行的 wb_id 存储此用户的微博 id,以后用任意账号登陆即可,第一次微博登陆之后用户只需要设置一下昵称(非必须,可直接使用微博昵称)和密码(必须,因为万一以后新浪微博倒闭了,用户没法儿登陆可不行);另一种方式是新浪微博登陆之后需要引导用户手动创建一个账号和密码,或者引导用户绑定到已经注册过的用户账号上去.

我的做法

好了以上是业务逻辑,我会使用第一种方式实现,下面是具体的实现方法:如何使用新浪微博的 JSSDK 的 API.
首先和网上大多数教程里面说的那样,需要了解 OAuth2.0 协议的原理,其实不了解也没关系,知道流程就行,OAuth2.0 验证流程网上说的很多了,百度一大把,这里就不再赘述了.

注意:所有步骤的前提是,你已经取得了新浪微博开放平台的开发者权限,如果没有的话是无权调用 API 的,关于新浪微博开发者申请,请自行百度.申请完新浪微博开发者之后会到一个 appid,这个是新浪识别谁调用了它的 API 的关键 id,之后的步骤也会用到.

第一步:增加命名空间,引用 jssdk 文件.

增加命名空间:

1	`<html xmlns:wb=”http://open.weibo.com/wb”>`

引用 jssdk 文件:

1	`<script src=”http://tjs.sjs.sinajs.cn/open/api/js/wb.js?appkey=YOUR APPKEYdebug=true” type=”text/javascript” charset=”utf-8″></script>`

其中的YOUR APPKEY替换为你申请新浪微博开发者时它给你的appid, debug=true方便你调试,正式上线时可以把&debug=true这个给删掉.

第二步:使用 API 授权登录

这里有两种方式,一种是点击按钮之后直接在脚本里调用 API 的WB2.login()方法具体请看新浪 API,

还一种是将用户引导到包含你 appid 和回调地址的地址中去(姑且叫它授权页),格式为:

1	`https://api.weibo.com/2/oauth2/authorize?client_id=YOUR APPKEY&response_type=token&display=js&transport=html5&referer=Your_CallBack_Address`

其中的YOUR APPKEY和Your_CallBack_Address替换为你自己的,注意Your_CallBack_Address记得加上http://
比如我的测试引导地址就是:

1	`https://api.weibo.com/2/oauth2/authorize?client_id=2177891434&response_type=token&display=js&transport=html5&referer=http://www.xheldon.com/gbtagsLogin.html`

注意:貌似这个回调地址必须是以 php/html/jsp 等动态/非动态的带后缀名的格式,如果是首页的话比如http://xheldon.com是不行的,需要加上http://xheldon.com/index.html(因为我的后台是 Node 的)才行,这个我没有试过,有需要的同学请自行尝试.

第一种方法的表现形式是点击引导入口之后会直接弹出微博登陆授权页面的对话框,这个时候如果你用过的是chrome的话会发现在这个小窗口的地址栏左侧的地址有个小锁 icon,代表这个地址是锁定的无法修改.
在弹出的小窗口输入微博登陆账号密码授权之后对话框消失,原来的页面刷新,第三方网站就可以操作你的账号.

第二种方法是不在脚本中使用WB2.login(),而是引导用户到刚才我说的那个包含 appid 和回调地址的地址中去,这个地址也是会让你输入账号密码,但是这个和第一种方式的区别是这个是会离开现有的页面跳转到这个授权页中去的,输入账号密码授权之后会回到你这个链接中写的回调地址中去.

以上两步的原理其实就是OAuth2.0协议认证的过程,只是 JSSDK 给你处理好了第一次请求返回的 code 和第二次请求返回的access token,因此你不需要按照官方 API 里面说的那样运用basic方式将access token放到header中使用 post 或者 get 方式等一系列你可能听不懂的名词,而只需要关注前端的逻辑,使用获得的 json 格式的数据即可.

还是刚才那个地址, 微博 API 入口级文档说明.当然”入口级”这个名词是我自创的,你知道了这五个的用法,以后的 API 就可以依葫芦画瓢了.

这几个 API 其中的WB2.login() 和WB2.checklogin()以及WB2.logout比较简单,是个人都能看懂,看不懂的按照我刚才说的那个WB2.login()方法往 script 标签里面一放就可以了,只是引导登陆之后你什么也没有做.

登陆之后想做点什么的话(这是废话,不做什么你让人家登陆干啥),比如获取登陆新浪微博登陆用户的 id,获取它的粉丝数等等,都是通过这五个入口级 API 的最重要的一个 API
即与微博 API 进行数据交互及采用 Js 方式调用内置微博组件的入口函数(官方是这么介绍的):WB2.anyWhere(callback),

然后与数据交互的话需要使用W.parseCMD(uri, callback, args, opts)
其中 W 形参是WB2.anyWhere(callback)传进去的,如果想调用微博组件的话,可以使用W.widget.hoverCard(…)或者W.widget.followButton(…);等等.

注意,最最重要的一步,即是你和新浪的数据交互的一步:

一般W.parseCMD的用法是以下形式:

W.parseCMD(
  '/users/show.json',
  function (oResult, bStatus) {
    if (bStatus) {
      //to do something...
    }
  },
  {
    screen_name: '姚晨',
  },
  {
    method: 'get',
    cache_time: 30,
  }
);

其中W.parseCMD()的第一个参数/user/show.json可以换成其他的接口如:/statuses/user_timeline.json就可以读取这个借口的信息了,具体有哪些接口,而接口又能返回哪些数据,新浪自己给了个微博 API 测试工具注意:这个 API 测试工具的登陆界面有问题,请不要在这个页面登陆,而是先到微博首页登陆之后再在这个 API 测试工具的页面刷新即可.
那个screen_name不是必须的,但是screen_name所在的{}必须保留,即使它是空的.

下面的method: get是与后台交互时的参数,有时候的交互是需要使用post方式,cache_time看名字也知道什么意思吧?就不多说了.

差不多需要注意的就这么多.

- EOF -

本文最先发布在: 新浪微博JS SDK API的使用 - Xheldon Blog

博主说：

我常常希望在面对人生中一些关键抉择的时候，有人可以告诉我最佳的做法，让我不至于白白浪费宝贵的时间。推己及人，我因此经常写博客，以期在浩渺无垠的互联网中的这个小小角落里记录下对于我来说只有一次的人生经历，希望能够帮到那些希望得到帮助的人。

专栏

开源项目技术书单订阅&付费软件美食推荐

新浪微博JS SDK API的使用

前言

现状

我的做法

目录

博主说：

热门标签

专栏

朋友们