小程序开放平台

文档中心
API 简介
登录
接口调用凭证
小程序码与链接
小程序基础信息
本地担保交易能力
通用担保交易能力
电商担保交易能力
地点管理能力
客服能力
群聊能力
小说能力
短剧能力
查询剧目列表
查询剧目下的剧集列表
服务组件能力
直播能力

查询剧目列表

开发
>
服务端 API
>
短剧能力
>
查询剧目列表
>
更新时间:2025-05-22 21:15:08

支持第三方调用

支持沙箱环境调用

禁止个人开发者调用

查询剧目列表

请求地址

POST https://miniapp.xiaohongshu.com/api/rmp/v2/album/album_list

公共请求参数

名称
类型
是否必须
描述
app_idstring小程序appid
access_tokenstring小程序调用凭证

业务请求参数

名称
类型
是否必须
描述
page_noint32当前页码
page_sizeint32每一页的条数(最多 20 条/页)
album_statusstring状态(NOT_SUBMIT:未提交;AUDIT_REFUSE:审核驳回;AUDIT_PASS:审核通过;WAIT_AUDIT:审核中)

请求示例

{
    "page_no":0,
    "page_size":0,
    "album_status":"string"
}

响应参数

名称
类型
是否必须
描述
data
struct
album_list
list_struct剧目列表
album_id
string剧目id
album_name
string剧目名称
seq_num
string集数
summary
string内容概要
album_poster_url_list
list_string海报url列表
size
string剧目大小(单位Byte)
album_status
string剧目状态(NOT_SUBMIT:未提交;AUDIT_REFUSE:审核驳回;AUDIT_PASS:审核通过;WAIT_AUDIT:审核中)
create_time
string创建时间(格式:yyyy-MM-dd HH:mm:ss)
total
int64总数
successbool是否成功
msgstring说明,正确响应时为 success,错误响应时为错误描述
codeint32错误码,正确响应时为 0,错误响应时非0

响应示例

{
    "data":{
        "album_list":[
            {
                "album_id":"string",
                "album_name":"string",
                "seq_num":"string",
                "summary":"string",
                "album_poster_url_list":[
                    "string"
                ],
                "size":"string",
                "album_status":"string",
                "create_time":"string"
            }
        ],
        "total":0
    },
    "success":true,
    "msg":"string",
    "code":0
}

业务错误码

参见错误码