OpenAPI微信开放接口
一、简介
MoreTV微信开放接口,向合作伙伴提供视频搜索数据接口,并提供一个支持微信内推送视频播放的页面地址。
搜索结果有两类页面,具体根据搜索关键词产生的结果而定。如果搜索结果少于5条,则提供所有结果的节目详情列表;若大于5条,则提供前4条结果的节目详情,再加一个“更多”的链接。
- 微信搜索结果
- 节目详情页
- 更多搜索列表页
保证手机和TV在同一局域网内,点击推送播放,并与TV端电视猫应用绑定后(只需第一次使用时绑定),可在微信界面上操控视频播放。
二、接口定义
1、请求接口
- 承载协议:HTTP(POST/GET分别对应两种方式,两种方式任选其一)
- 接口方向:开发者接口API → MoreTV微信API
- 调用逻辑:
当普通微信用户向公众账号发消息时,微信服务器将POST该消息到开发者接口API上。结构如下(文本信息):
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1348831860</CreateTime> <MsgType><![CDATA[text]]></MsgType> <Content><![CDATA[this is a test]]></Content> <MsgId>1234567890123456</MsgId> </xml>
开发者接口解析消息内容,若需要通过MoreTV微信开放接口,获取关键词搜索数据,可用选择以下两种方式之一。
接口方式一(POST模式)
将微信服务器发过来的POST数据透传POST给MoreTV微信API
接口方式二(GET模式)
将搜索关键词作为keyword参数,请求MoreTV调用接口。例如:http://openapi.moretv.com.cn/openApi/Service/Weixin?keyword=%25E4%25B8%2580%25E4%25BB%25A3%25E5%25AE%2597%25E5%25B8%2588
字段说明: keyword:搜索中文关键字做两次URLencode。例如:URLencode(URLencode(“中文搜索词”))
eg:"一代宗师"转义后的keyword为:%25E4%25B8%2580%25E4%25BB%25A3%25E5%25AE%2597%25E5%25B8%2588
2、返回数据
MoreTV微信开放接口的返回数据格式和微信公众平台的消息接口保持一致。回复类型的是图文信息。格式如下:
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>12345678</CreateTime> <MsgType><![CDATA[news]]></MsgType> <ArticleCount>2</ArticleCount> <Articles> <item> <Title><![CDATA[title1]]></Title> <Description><![CDATA[description1]]></Description> <PicUrl><![CDATA[picurl]]></PicUrl> <Url><![CDATA[url]]></Url> </item> <item> <Title><![CDATA[title]]></Title> <Description><![CDATA[description]]></Description> <PicUrl><![CDATA[picurl]]></PicUrl> <Url><![CDATA[url]]></Url> </item> </Articles> </xml>
注:当请求方式为GET模式时,ToUserName, FromUserName,CreateTime等字段为空。
- moretv微信公众号