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
