文档首页/ 云空间服务 KooDrive/ API参考（运营商）/ API/ 相册管理/ 列举相册文件 - ListAlbumContent
更新时间：2026-02-03 GMT+08:00
查看PDF
分享

列举相册文件 - ListAlbumContent

功能介绍

列举相册文件

授权信息

当前API调用无需身份策略权限。

URI

GET /koodrive/ose/v1/album/{albumId}/list

表1 路径参数

参数

是否必选

参数类型

描述

albumId

是

String

参数解释：

相册ID

约束限制：

使用创建相册返回的ID

取值范围：

不涉及

默认值：

不涉及
表2 Query参数

参数

是否必选

参数类型

描述

pageSize

否

String

参数解释：

分页数量

约束限制：

不涉及

取值范围：

[1,100]

默认值：

100

pageCursor

否

String

参数解释：

起始游标，为空时从第一页开始查询

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及

sortType

否

String

参数解释：

排序类型

约束限制：

不涉及

取值范围：

1拍摄时间； 2创建时间； 3更新时间

默认值：

手工相册中默认为创建时间倒序；收录相册中默认为拍摄时间倒序

sortDirection

否

String

参数解释：

排序顺序：

约束限制：

不涉及

取值范围：

1升序 2降序

默认值：

2

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

参数解释：

该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及

X-Date

是

String

参数解释：

日期，用于app鉴权

约束限制：

日期格式：yyyyMMDD'T'HHmmss'Z' ; 例如20251103T070140Z

取值范围：

距当前时间15分钟以内，不能晚于当前时间

默认值：

不涉及

X-User-Id

是

String

参数解释：

KooDrive侧用户id，用于app鉴权

约束限制：

不涉及

取值范围：

不涉及

默认值：

不涉及

X-Traceid

否

String

参数解释：

业务跟踪id（必须58位）

约束限制：

不涉及

取值范围：

长度为58位

默认值：

不涉及

language

否

String

参数解释：

国际化语言标识

约束限制：

符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语

取值范围：

不涉及

默认取值：

不传默认美式英语

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

contentList

Array of AlbumContent objects

内容列表

nextPageCursor

String

下次查询游标

total

Integer

总数
表5 AlbumContent

参数

参数类型

描述

id

String

文件id

takeTime

String

拍摄时间; 在收录相册时返回

ownerId

String

文件拥有者

fileName

String

文件名

mimeType

String

描述消息内容类型的标准，用来表示文档、文件或字节流的性质和格式

fileType

String

文件分类

fileSuffix

String

后缀名/扩展名

parentFolder

Array of strings

父目录

containers

Array of strings

容器ID

createdTime

String

创建时间

editedTime

String

更新时间

recycled

Boolean

是否已被回收

contentUrl

String

内容地址

thumbnailUrl

String

缩略图地址

favorite

Boolean

是否收藏

addTime

String

手工相册照片的添加时间

size

Long

文件大小

creatingUser

String

创建者用户id，家庭相册的创建者可能会与不一致

adderUserId

String

图片添加者的ID，在手工相册时候会返回

请求示例

查询相册内容列表请求

/koodrive/ose/v1/album/1795607640592646273/list

pageSize=100&pageCursor=0&sortType=1&sortDirection=2

响应示例

状态码：200

查询相册内容列表响应

{
    "contentList": [
        {
            "id": "FsZe6OnbZbVM0XcvEK_FDXqnow9P02vxT",
            "ownerId": "1765263620687613825",
            "fileName": "ims_kt=url&at=ori&key=aHR0cDovL2NpLnhpYW9ob25nc2h1LmNvbS9iODQwNjEzYS1mMzZiLTBlOWUtYzYzYi0xZWEwNmMyYmU2NWU_aW1hZ2VWaWV3Mi8yL3cvMTA4MC9mb3JtYXQvanBn&sign=yx_1vrJ0n2LhWeGrxWPaXNLuQvRJ-U=&tv=0_0.jpg",
            "mimeType": "image/jpeg",
            "fileType": "15",
            "fileSuffix": "jpg",
            "parentFolder": [
                "DGH956YIDkQArootIAACulBh_eemCA5EA1765263622625382272"
            ],
            "containers": [
                "IAACulBh_eemCA5EA1765263622625382272"
            ],
            "createdTime": "2025-09-16T01:31:20.654Z",
            "editedTime": "2025-09-16T01:31:22.219Z",
            "recycled": false,
            "contentUrl": "https://obs-xxx.myhuaweicloud.com/a0134878508b4ab2b1c96820dca2f31c086?response-content-disposition=attachment%3B%20filename%2A%3DUTF-8%27%27ims_kt%253Durl%26at%253Dori%26key%253DaHR0cDovL2NpLnhpYW9ob25nc2h1LmNvbS9iODQwNjEzYS1mMzZiLTBlOWUtYzYzYi0xZWEwNmMyYmU2NWU_aW1hZ2VWaWV3Mi8yL3cvMTA4MC9mb3JtYXQvanBn%26sign%253Dyx_1vrJ0n2LhWeGrxWPaXNLuQvRJ-U%253D%26tv%253D0_0.jpg&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20251027T091151Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=HPUA8WFGVY35JSJDL1GV%2F20251027%2Fnorth-4%2Fs3%2Faws4_request&X-Amz-Signature=ea332f33588b46fe8a379ec04bbb9f9b02ddbbe0fbb794f5c3913b4e02f8bd09",
            "thumbnailUrl": "https://obs-xxx.myhuaweicloud.com/a0134878508b4ab2b1c96820dca2f31c086?x-image-process=image%2Fresize%2Cm_lfit%2Ch_128%2Cw_128&response-content-disposition=attachment%3B%20filename%2A%3DUTF-8%27%27ims_kt%253Durl%26at%253Dori%26key%253DaHR0cDovL2NpLnhpYW9ob25nc2h1LmNvbS9iODQwNjEzYS1mMzZiLTBlOWUtYzYzYi0xZWEwNmMyYmU2NWU_aW1hZ2VWaWV3Mi8yL3cvMTA4MC9mb3JtYXQvanBn%26sign%253Dyx_1vrJ0n2LhWeGrxWPaXNLuQvRJ-U%253D%26tv%253D0_0.jpg&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20251027T091151Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=HPUA8WFGVY35JSJDL1GV%2F20251027%2Fnorth-4%2Fs3%2Faws4_request&X-Amz-Signature=7b2a6a3eb60ab7ba5811c74b24fb450b806ac1541a3a5f0d09307d44ea505822",
            "favorite": false,
            "addTime": "2025-10-13T03:12:07.862Z",
            "size": 64492,
            "creatingUser": "1765263620687613825",
            "adderUserId": "1765263620687613825"
        },
        {
            "id": "Fg7cEpaAoh1ZmUxfCPlFEMpvIfUwiKxZW",
            "ownerId": "1765263620687613825",
            "fileName": "ms_kt=url&at=ori&key=aHR0cHM6Ly9xY2xvdWQuZHBmaWxlLmNvbS9wYy9XUnZfSk9iOTYzVm1vbjJkQTlQY0lLV25GWVlnTWxIY2RGb2tYSGVESWNSNjV6Y0dDd0szVU1WbV8tMlI4S0xUWTBxNzNzQjJEeVFjZ21LVXhaRlF0dy5qcGc=&sign=yx_CIR6buct8Z.jpg",
            "mimeType": "image/jpeg",
            "fileType": "15",
            "fileSuffix": "jpg",
            "parentFolder": [
                "DGH956YIDkQArootIAACulBh_eemCA5EA1765263622625382272"
            ],
            "containers": [
                "IAACulBh_eemCA5EA1765263622625382272"
            ],
            "createdTime": "2025-09-16T01:31:22.088Z",
            "editedTime": "2025-09-16T01:31:23.179Z",
            "recycled": false,
            "contentUrl": "https://obs-xxx.myhuaweicloud.com/96e9758b7db047fcbc327266c85f1bd7086?response-content-disposition=attachment%3B%20filename%2A%3DUTF-8%27%27ms_kt%253Durl%26at%253Dori%26key%253DaHR0cHM6Ly9xY2xvdWQuZHBmaWxlLmNvbS9wYy9XUnZfSk9iOTYzVm1vbjJkQTlQY0lLV25GWVlnTWxIY2RGb2tYSGVESWNSNjV6Y0dDd0szVU1WbV8tMlI4S0xUWTBxNzNzQjJEeVFjZ21LVXhaRlF0dy5qcGc%253D%26sign%253Dyx_CIR6buct8Z.jpg&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20251027T091151Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=HPUA8WFGVY35JSJDL1GV%2F20251027%2Fnorth-4%2Fs3%2Faws4_request&X-Amz-Signature=9aae3b0102968f632be825e812a3a3d1131909bd0815dabf11eff4793a2d7d79",
            "thumbnailUrl": "https://obs-xxx.myhuaweicloud.com/96e9758b7db047fcbc327266c85f1bd7086?x-image-process=image%2Fresize%2Cm_lfit%2Ch_128%2Cw_128&response-content-disposition=attachment%3B%20filename%2A%3DUTF-8%27%27ms_kt%253Durl%26at%253Dori%26key%253DaHR0cHM6Ly9xY2xvdWQuZHBmaWxlLmNvbS9wYy9XUnZfSk9iOTYzVm1vbjJkQTlQY0lLV25GWVlnTWxIY2RGb2tYSGVESWNSNjV6Y0dDd0szVU1WbV8tMlI4S0xUWTBxNzNzQjJEeVFjZ21LVXhaRlF0dy5qcGc%253D%26sign%253Dyx_CIR6buct8Z.jpg&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20251027T091151Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=HPUA8WFGVY35JSJDL1GV%2F20251027%2Fnorth-4%2Fs3%2Faws4_request&X-Amz-Signature=a1d6573d29dc63dbefa2709f24278b7557362732e529039265f2d81e70f4c94f",
            "favorite": false,
            "addTime": "2025-10-13T03:12:07.862Z",
            "size": 89088,
            "creatingUser": "1765263620687613825",
            "adderUserId": "1765263620687613825"
        },
    ],
    "total": 3,
    "code": 0,
    "msg": "Success."
}

状态码

状态码

描述

200

查询相册内容列表响应
父主题： 相册管理