微信开发者迁移指南

跳转到: 导航, 搜索

如果你在使用微博粉丝服务平台之前,已经做过微信公众平台的开发了,那么强烈推荐阅读本文档,了解迁移过程中需要注意的细节问题;


微博粉丝服务接口在设计之初就考虑到了微信开发者的迁移问题,所以迁移成本并不高;但是开发者仍然需要针对以下三个区别做一定适配:

区别一:申请消息接口时,微信填Token,微博填Appkey

申请消息接口的时候,微博需要开发者填写URL和Appkey,而微信则是要求开发者填写URL和Token;


微信的Token是由开发者任意填写的字符,仅仅用于“验证URL有效性”使用;

而微博的Appkey则是由微博官方提供的,除了用于“验证URL有效性”,还用于代表开发者身份;


在“验证URL有效性”环节,开发者的Appkey所对应的AppSecret被用作生成signature签名;换句话说,微博的signature字段加密流程和微信基本是一样的,唯一的区别是微信加密用到的Token字段,微博是用AppSecret字段替代;

区别二:access_token生成方式不同,有效期也不同

微信的access_token获取方式是通过公众号的AppID和AppSecret调用相应接口来获取;

而微博的粉丝服务接口调用时的access_token凭证,是在 申请消息接口 是时候,验证URL成功后,粉服平台自动返回的(如下图);

另外,微博的粉丝服务接口的access_token凭证,还可以通过微博的OAuth2.0授权接口获取,不过这个目前在开发中,暂未上线;

关于有效期,微信的access_token的有效期是为7200秒,需要开发者不断去刷新; 但微博的粉丝服务接口的access_token凭证,有效期为一年,开发者可以一年之后再找蓝V账号重新绑定或者授权;



关于微博access_token的更多介绍可以参见:

区别三:接口参数有一定差异

验证URL有效性成功后即接入生效,成为开发者。


建立首次连接后,后续每次微博事件推送时也都会带上signature、timestamp、nonce三个参数,开发者依然可以通过对signature的校验判断此条消息的真实性。校验方式与首次建立连接一致。


此后用户每次向微博认证帐号发送消息、或者产生自定义菜单点击事件时,响应URL将得到推送。


此外请注意,粉服平台开发接口只支持80接口。

获取access token

除了接收消息事件的推送服务外,微博粉服开发模式还提供了很多功能性接口,调用这些接口需要完成微博认证帐号对第三方开发者的授权,获取到access token。具体可参见:



长连接模式

除了以上的推送接入模式外,我们还提供了额外的长连接接入模式。该模式除了接入的技术方法不同外,功能上都是完全一样的。


长连接模式的特点是,第三方开发者主动建立连接请求,长连接建立后,有新的消息事件将实时返回给第三方开发者,而不是被动等待微博消息服务器的GET请求,第三方开发者的控制自主性更强一点,但相应的开发难度也会大一些。


喜欢长连接模式的人,可以参见如下文档,进行接入: