新浪SEA开放平台开发文档

更新时间2022-04-11

新手接入指南

粉丝服务平台开发接口介绍

粉丝服务平台（以下简称粉服平台）是为微博认证用户提供服务的平台，而粉服平台开发接口则是提供服务的基础。微博认证用户在粉服平台网站中打开开发模式、指定并授权为其服务的第三方开发者、获取接口权限后，第三方开发者即可以通过本接口文档来帮助该微博认证用户开发应用。

粉服平台开发接口提供与用户进行消息交互、自定义菜单交互的能力。对于成功接入粉服平台开发接口的微博认证帐号，当用户发消息给微博认证帐号，微博粉服平台服务器会使用http请求对接入的网址进行消息推送，第三方服务器可通过响应包回复特定结构、或者另外调用客服回复接口，从而达到回复消息的目的。

现在就开始 - 指南文档

验证消息真实性

第三方微博帐号在粉服后台绑定接收消息URL时，需要原样返回echostr参数内容才能绑定成功，否则绑定失败。
接收普通消息

接收普通消息是指接收用户向第三方微博帐号发送的文本，位置，语音，图片消息。
接收事件推送

接收事件推送主要指接收用户的关注/取消关注，订阅/取消订阅，扫描带参数二维码等事件。
微信XML格式兼容

微博粉丝服务平台完全兼容微信XML格式，开发者可以通过http://open.weibo.com/wiki/Eps/push/set_format 接口选择自己接收到的信息是微信XML格式还是JSON格式。

发送被动响应消息

对于每一个POST请求，开发者在响应包（Get）中返回特定JSON结构或者XML结构，对该消息进行响应（现支持回复文本、图文消息）。
发送客服消息

当用户主动发消息给认证账号后，微博将会把消息数据推送给开发者，开发者可以调用客服消息接口一定次数。用户发送消息，关注/订阅事件，点击自定义菜单，扫描二维码事件后，目前修改为开发者在48小时内不限制发送次数；用户@事件，开发者在48小时内可以回复一次。