bShare RESTful分享API以RESTful的形式提供了一种可编程的方式,使站长可以容易的从PHP、Java甚至手机应用中分享内容到各大平台。
请求链接
请求方法
GET/POST认证方法
此API的认证方式有以下两种:
通过HTTP Basic Authentication中的用户名、密码(以英文冒号":"分割)进行认证
通过URL参数中的username和password参数进行认证
注意Basic认证的优先级高于username和password。如果两者都失败了,则返回认证失败。
参数
以下除site外其他所有参数均为可选,但调用时首先必须按前述方式通过认证,然后url,title和summary三者不能同时为空。所有的参数值都必须经过UTF-8格式的URL编码。
| site | 分享的目标平台(必须) |
| username | 用户在目标平台的用户名 |
| password | 用户在目标平台的密码 |
| publisherUuid | 站长的UUID,不指定则无法追踪数据 |
| url | 分享的链接 |
| title | 分享的标题 |
| summary | 分享的内容摘要 |
| pic | 分享的图片的链接,支持新浪微博,搜狐微博,腾讯微博等平台 |
| latitude | 纬度。有效范围:-90.0到+90.0,+表示北纬(仅支持新浪微博) |
| longitude | 经度。有效范围:-180.0到+180.0,+表示东经(仅支持新浪微博) |
| appKey | 你的App Key,和appSecret同时指定后会替换bShare默认的应用“蜂享”(仅支持新浪微博,且App必须有Xauth权限) |
| appSecret | 你的App Secret,和appKey同时指定后会替换bShare默认的应用“蜂享”(仅支持新浪微博,且App必须有Xauth权限) |
支持平台
sinaminiblog,sohuminiblog,digu,zuosa,renren和kaixin001.
返回结果
如果出错,返回对应的HTTP状态码及错误信息,例如:
否则,HTTP状态码为200,返回JSON格式的相关分享数据,例如:
其中 accountUid是分享用户在平台里的用户ID,statusUrl则是分享的微博的URL,destination则是微博的ID。注意目前只有新浪微博和搜狐微博会返回详细分享数据,其他的平台detail部分内容为空。