微信开发者迁移指南

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


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

区别一:申请消息接口时,微信填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帐号重新绑定或者授权;


getaccesstoken2014.jpg


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


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

1. 关于 接收消息 和 发送被动消息 两个功能,微信是推送XML格式,微博默认是推送JSON格式,但微博针对微信XML格式也做了兼容;

如果第三方开发者想使用微信XML兼容格式,可以通过http://open.weibo.com/wiki/Eps/push/set_format 接口来切换自己需要的格式是XML还是JSON,更多详情可以参考微信XML格式兼容;


2. 关于 发送客服消息 功能,微信的调用参数是access_token,touser,msgtype和消息内容,微博的相应参数是access_token,receiver_id,type和data字段;文档里面的id,source字段主要用来支持老版本的粉丝服务,新接入的开发者请忽略之;

微博的 发送客服消息 功能目前只支持纯文本,图文消息和位置信息三种类型的格式;