Kidsdb/search snap
目录 |
kidsdb/search_snap
按关键字,地理信息等方式搜索街拍
URL
http://api.t.sina.com.cn/kidsdb/search_snap.json
支持格式
JSON
HTTP请求方式
GET/POST
是否需要登录
true
关于授权机制,参见授权机制声明
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。格式为:"key:secret"(采用OAuth授权方式不需要此参数) |
sub_uid | true | int64 | 提交者微博用户ID |
q | false | string | 搜索的关键字 必须进行URL Encode |
l | false | string | 街拍拍摄位置 必须进行URL Encode 如:团结湖 |
page | false | int | 页码.默认为第一页 |
pagesize | false | int | 单页记录. 默认为50条 |
gender | false | string | 性别 m:男,f:女, u:未知 |
province | false | string | 街拍地点所在省份代码 |
city | false | string | 街拍地点所在城市代码 |
tags | false | string | 街拍特征信息标签,多个用","分割, 必须进行URL Encode 如:聋哑 |
mtime_scope | false | DATETIME | 街拍的时间范围。参数格式为 "开始时间,结束时间" 如: "2010-3-18,2010-4-25" 仅列出 3月18日到4月25日更新的街拍。 |
注意事项
若不输入任何请求参数,则返回已审核街拍列表,结果按照更新时间倒序排序。
调用示例
curl -u "username:password" "http://api.t.sina.com.cn/kidsdb/search_snap.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:街拍的创建时间