微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
==对象数据回调(Object Data Callback)== 本文档介绍了对象数据回调接口(Object Data Callback API)的开发规范,和通过此接口完成对象数据回调采集给微博平台,并最终接入对象库。需要特别指出的是,这个接口是需要你(开发者)来开发并提供给微博平台的。 对象数据回调是兴趣图谱(Open Graph)的一部分。要了解更多有关兴趣图谱的内容,请阅读 [[opengraph/object|兴趣图谱(Open Graph)]]。对象数据回调也是接入对象库的方法之一,对象也可以采用在你的页面中部署微博元标记(Weibo Meta Tags)的方法来创建接入,具体请阅读 [[赞组件Weibo_Meta_Tags及对OpenGraph支持范畴说明文档|微博元标记(Weibo Meta Tags)]]。 ==链接匹配规则(URL Rule)== 采集对象数据时,为了识别、区分每一个开发者的网页,你需要提供一个能区分链接(URL)的规则。这个规则是一个简单的通配或正则表达式。匹配上的URL在进入兴趣图谱的过程中,会调用你的对象数据回调接口(Object Data Callback API)。 示例: 我们需要采集新浪音乐播放页的音乐对象,则这个网页为类似于这样的URL地址: <pre> http://music.sina.com.cn/sample/256819 </pre> 则链接匹配规则(URL Rule)就应该为: <pre> music.sina.com.cn/sample/ </pre> ==对象数据回调接口(Object Data Callback API)== 当你的网页URL进入到微博时,比如被转为微博短链、URL被赞。这时为了采集到你的网页中所包含的对象数据,我们需要调用你的对象数据回调接口(Object Data Callback API)。你需要开发这个接口,并部署到服务器上,并将接口地址提供给微博平台。 该接口参数为网页链接(URL),也就是通过链接匹配规则(URL Rule)筛选出来的URL,接口返回对应网页上的结构化的对象数据,为JSON数据格式。 但是当我们请求的URL,你并不想将其接入对象库,你可以返回一个规范的错误数据,这时我们将不采集这个网页URL的对象数据。 ===对象数据回调接口(Object Data Callback API)规范=== 接口请求方式: <pre> GET </pre> 接口传递参数: <pre> url 必填 符合链接匹配规则(URL Rule)的URL </pre> 接口返回值规范,JSON格式: <pre> 成功返回 { 对象数据(JSON) } 失败返回 { "errcode": "-1", "msg": "your msg here" } </pre> 对象数据格式,需要是一个标准的JSON数据格式。其属性字段有常用、通用属性,而某些特殊对象类型也有其特有、独有的属性字段。比如:视频(video)对象,就有stream这样的特殊属性字段。 对象(Object)都有各自的类型,比如一个页面描述的是一本书,则其对象类型就应该为book。其中,webpage是最基本的对象类型,如果你搞不清楚自己的类型,都可以选此类型。 想要了解更多有关于结构化的对象数据,请阅读 [[opengraph/object|对象(Object)规范]]。 示例: 我们继续完成上面的例子,采集新浪音乐播放页的音乐对象。 提供的链接匹配规则(URL Rule): <pre> music.sina.com.cn/sample/ </pre> 提供的对象数据回调接口(Object Data Callback API): <pre> http://music.sina.com.cn/api/get_data?url= </pre> 调用实例: <pre> http://music.sina.com.cn/api/get_data?url=http://music.sina.com.cn/sample/256819 </pre> 你的返回数据: <pre> { "display_name": "鸽子", "image": { "url": "http://music.sina.com.cn/7272.jpg", "width": 300, "height": 300 }, "author": { "display_name": "宋冬野", "url": "http://music.weibo.com/t/s/1613258127.html", "object_type": "person" }, "stream": { "url": "http://music.weibo.com/t/i/100050599.mp4", "duration": "232" }, "summary": "2012年由个人发行发行", "url": "http://music.weibo.com/t/i/100050599.html", "links": { "url": "http://music.sina.cn/h5/100050599" }, "tags": [ { "display_name": "流行音乐" } ], "create_at": "2012-10-18", "object_type": "audio" } </pre> __NOTOC__
返回到
Opengraph/object data callback
。
反馈
分享
顶部