Kidsdb/get snap info
目录 |
kidsdb/get_snap_info
取得一个或者多个街拍的详细信息
URL
http://api.t.sina.com.cn/kidsdb/get_snap_info.json
支持格式
JSON
HTTP请求方式
GET/POST
是否需要登录
true
关于授权机制,参见授权机制声明
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。格式为:"key:secret"(采用OAuth授权方式不需要此参数) |
sub_uid | true | int64 | 提交者微博用户ID |
pic | true | binary | 要上传的照片。仅支持JPEG,GIF,PNG图片,为空返回400错误。目前上传图片大小限制为<2M |
gender | false | string | 性别代码. "f" 为女性, "m"为男性 若性别未知可不输入此参数。 |
desp | false | string | 街拍描述。 |
tags | false | string | 特征信息标签,多个用","分割。 例: "西单地铁,聋哑" |
xy | false | string | 街拍地点的坐标。格式为 "经度,纬度"。 例: "116.30999,39.98440" |
province | false | string | 街拍地点所在省份代码 |
city | false | string | 街拍地点所在城市代码 |
location | false | string | 街拍的具体位置描述. 例:北京市朝阳区团结湖地铁C口 |
link_id | false | string | 街拍别名,同一组街拍中,街拍ID的最小值。若为0或不输入此参数,则街拍不存在别名。 |
注意事项
采用multipart/form-data编码方式提交,可以参考: Form-based File Upload in HTML 第6段: Examples (http://www.ietf.org/rfc/rfc1867.txt)
调用示例
curl -u "username:password" "http://api.t.sina.com.cn/kidsdb/get_snap_info.json?source=appkey{{{getParam}}}"
返回结果
字段说明 snap
- snap_id:添加的街拍 UID
- link_id:街拍别名,同一组街拍中,街拍ID的最小值。若为0,则街拍不存在别名。
- photo_url:原始照片地址
- photo_thumb_url:照片缩略图地址
- gender:性别 m:男,f:女, u:未知
- desp:街拍描述
- tags:街拍特征信息标签数组 {"Tag1", "Tag2" ...}
- xy:街拍地点的坐标 "x,y" X为经度,y为纬度 例: "116.30999,39.98440"
- province:街拍地点所在省份代码
- city:街拍地点所在城市代码
- location:街拍的具体位置描述
- status:街拍状态代码 0:等待审核,等待匹配 1:审核通过, 等待匹配 2:审核通过,匹配成功 3:未通过审核, 等待匹配
- sub_uid:提交街拍用户的微博用户ID
- ctime:街拍的创建时间
其他
文档更新时间: 2011-03-07