MultiArticleV2 - 获取多条内容--内容定制-火山引擎

文档中心

导航

MultiArticleV2 - 获取多条内容

最近更新时间：2024.05.28 18:13:34首次发布时间：2021.10.18 11:12:18

传入多个GroupId，批量的获取内容详情。

使用场景

本接口主要针对需要实现收藏场景的客户。您可以通过调用该接口获取内容状态和内容详情，避免C端用户访问到已下架的内容。
您需要自行实现在列表页或者详情页收藏文章/视频内容，在用户收藏内容时，将用户及内容id的对应关系存下，在用户进入收藏列表页时，调用本接口以获取内容标题、封面图、作者信息等，并实现自定义UI。

请求说明

请求方式：GET/POST(Content-Type: application/x-www-form-urlencoded)
请求地址：https://mercury.volcengineapi.com/?Action=MultiArticleV2&Version=2021-01-01
请求头：ServiceName:content

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	MultiArticleV2	要执行的操作，取值：MultiArticleV2。
Version	String	是	2021-01-01	API的版本，取值：2021-01-01。
ApiVersion	Integer	是	4	接口版本，固定传4。
Partner	String	是	xxx_default_content	渠道号。
AccessToken	String	是	AT6zTZuXzffKpQamerBKVv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNhxxxKTT12	用户唯一标识。
GroupIDs	String	是	7147515926185771528,7147160542665261581	内容id列表。最多支持20个GroupID，多个GroupID以英文逗号进行分隔。
CustomVideoDefinition	String	否	360p	指定视频分辨率。枚举值：360p、480p、540p、720p、1080p、all（全部）。横版短视频支持：360p（默认）、480p、540p、720p、1080p；竖版小视频支持：540p(默认)；默认不传时，短视频下发360p，小视频下发540p，传all时下发视频所有的分辨率。如果请求的分辨率对于该视频不存在，则会自动降级一档返回内容作为兜底。注意分辨率的升档会增加cdn的播放成本，需客户侧谨慎评估，详细咨询火山引擎侧。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
Result	Map		内容详情，Map< GroupId,Article >。其中Article结构同获取单条内容返回参数。

请求示例

GET /?Action=MultiArticleV2&Version=2021-01-01&ApiVersion=4&Partner=xxx_default_content&AccessToken=AT6zTZuXzffKpQamerBKVv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNhxxxKTT12&GroupIDs=7147515926185771528 HTTP/1.1
Host: https://mercury.volcengineapi.com/?Action=MultiArticleV2&Version=2021-01-01
X-Date: 20240522T074425Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240522/cn-north-1/content/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

返回示例

{
    "ResponseMetadata": {
        "Action": "MultiArticleV2",
        "Region": "cn-north-1",
        "RequestId": "2024052215454519999365B7CF53465CBC",
        "Service": "content",
        "Version": "2021-01-01"
    },
    "Result": {
        "7147515926185771528": {
            "Abstract": "",
            "ArticleType": "小视频",
            "ArticleUrl": "https://feedcoop.douyin.com/d7147515926185771528/?a_t=AT6zTZuXzffKxxxmerBKVv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BhZyxxx6VE&form_scen=FROM_ARTICLE&group_id=7147515926185771528&item_id=7147515926185771528&label=article&platform_source=1&req_id=2024052215454519999365B7CF53465CBC&utm_campaign=open&utm_medium=webview&utm_source=xxx_default_content",
            "CommentCount": 15,
            "CommentUrl": "https://feedcoop.douyin.com/d7147515926185771528/comment/?a_t=AT6zTZuXxxxKpQamerBKVv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BhZyxxx6VE&form_scen=FROM_ARTICLE&group_id=7147515926185771528&label=share&platform_source=1&req_id=2024052215454519999365B7CF53465CBC&utm_source=xxx_default_content",
            "CoverImages": [
                {
                    "Height": 1280,
                    "Url": "https://p9-open-sign.onewsimg.com/tos-cn-p-0015/c652f312926340c893e4b16a567725ac_1664160701~tplv-tt-cut:720:1280.jpeg?lk3s=95712c29&scene=content_consumer&x-expires=1779435945&x-signature=7vjHofZjwFxOyN%2FnTGyt10ZZdBM%3D",
                    "Width": 720
                }
            ],
            "CoverMode": 1,
            "DiggCount": 24654,
            "DiggStatus": false,
            "GroupId": "7147515926185771528",
            "HasVideo": true,
            "PublishTime": 1664160698,
            "ShareCount": 148,
            "ShareUrl": "https://feedcoop.douyin.com/d7147515926185771528/?a_t=AT6zTZxxxffKpQamerBKVv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BhZyxxx6VE&form_scen=FROM_ARTICLE&group_id=7147515926185771528&label=share&platform_source=1&req_id=2024052215454519999365B7CF53465CBC&utm_campaign=open&utm_medium=webview&utm_source=xxx_default_content",
            "Title": "标题",
            "UserInfo": {
                "AvatarUrl": "https://p3-open-sign.onewsimg.com/aweme-avatar/tos-cn-i-0813_36ae279d0e8d4816944e91992a54faab~tplv-tt-cs0:300:300.jpeg?scene=core&x-expires=1779435945&x-signature=HJsgTk%2FCS1fz1X2ZaiA8%2BvRfydg%3D",
                "Description": "粉丝q:2910272316",
                "Follow": false,
                "FollowerCount": 13699552,
                "HomePage": "https://feedcoop.douyin.com/u461423528393187/?a_t=AT6zxxxXzffKpQamerBKVv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BMCixxxtn2n&label=article&media_id=0&platform_source=1&utm_source=xxx_default_content",
                "Name": "洋佳酱",
                "UserId": 461423528393187,
                "UserVerified": true,
                "VerifiedContent": ""
            },
            "VideoDetail": {
                "VideoDuration": 43.583,
                "VideoList": [
                    {
                        "Definition": "540p",
                        "Height": 1280,
                        "Url": "http://mercury.snssdk.com/video/url/?param=Q1qixxxxr8&partner=xxx_default_content&version=2&trans_vdata_to_content=1",
                        "Width": 0
                    }
                ]
            },
            "VideoWatchCount": 406869
        }
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。