weiyun_get_pic_list
1.接口说明
获取照片列表。
2.使用场景
3. 接口调用说明
3.1请求说明
| url | https://graph.qq.com/weiyun/get_photo_list |
| 支持验证方式 | oauth2.0 |
| 格式 | JSON |
| http请求方式 | GET |
| 是否需要鉴权 | 需要 |
| 接口调试 | 点击这里测试 |
3.2输入参数说明
各个参数请进行URL 编码，编码时请遵守 RFC 1738。
（1） 通用参数
OAuth2.0协议必须传入的通用参数，详见这里。
（2）私有参数
| 参数名称 | 是否必须 | 类型 | 描述 |
|---|---|---|---|
| offset | 必须 | int | 所有文件数目的偏移，从0开始计数 |
| number | 必须 | int | 请求文件的数量，取值1-200 |
3.3请求示例
以OAuth2.0协议为例（敏感信息都用*号进行了处理，实际请求中需要替换成真实的值）：
https://graph.qq.com/weiyun/get_photo_list? access_token=*************& oauth_consumer_key=12345& openid=****************& offset=0& number_type=20
3.4返回参数说明
| 参数说明 | 描述 |
|---|---|
| ret | 返回码 |
| msg | 如果ret<0，会有相应的错误信息提示，返回数据全部用UTF-8编码。 |
| data | json格式的返回数据 |
data数据说明
| 参数说明 | 描述 |
|---|---|
| file_total | 获取到的文件数 |
| content | 获取到的文件数据，json格式 |
content数据说明
| 参数说明 | 描述 |
|---|---|
| file_id | 文件ID，字符串（68字节） |
| name | 文件名 |
| ctime | 文件创建时间 |
| size | 文件大小 |
3.5返回码说明
0: 正确返回
其它: 失败。错误码说明详见：公共返回码说明。
微云私有返回码请参考《微云对外接口描述文档.doc》
3.6 正确返回示例
JSON示例：
{"data":{
"content":[
{
"file_ctime":"2013-03-01 09:30:43 000",
"file_id":"c5c026a7a8f0c97ef6addde663a7501aabb3f3d3-d288-4b92-8590-7be8efc6e2eb",
"file_name":"t1.jpg",
"file_size":"73314"
},
{
"file_ctime":"2013-03-01 09:31:30 000",
"file_id":"c5c026a7a8f0c97ef6addde663a7501a87f2efb5-b83f-4ef6-99fb-2649ad07af63",
"file_name":"lib.jpg",
"file_size":"33995"
}],
"file_total":2
},
"ret":0
}
3.7 错误返回示例
JSON示例：
{
"ret":201019
}
4.相关问题
你可以直接通过我们的支持系统查看更多问题或提问，也可以直接联系我们的在线客服，企业QQ：800030681