通过GroupId获取单条文章/视频内容的详情。
本接口主要针对需要实现收藏场景的客户。您可以通过调用该接口获取内容状态和内容详情,避免C端用户访问到已下架的内容。
您需要自行实现在列表页或者详情页收藏文章/视频内容,在用户收藏内容时,将用户及内容id的对应关系存下,在用户进入收藏列表页时,调用本接口以获取内容标题、封面图、作者信息等,并实现自定义UI。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | SingleArticleV2 | 要执行的操作,取值:SingleArticleV2。 |
Version | String | 是 | 2021-01-01 | API的版本,取值:2021-01-01。 |
ApiVersion | Integer | 是 | 4 | 接口版本,固定传4。 |
Partner | String | 是 | demo_default_content | 渠道号。 |
AccessToken | String | 是 | AT6zTZuXzffKpQamerBKVv8mp94LRxxxdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12 | 用户唯一标识。 |
CustomVideoDefinition | String | 否 | 360p | 指定视频分辨率。
注意 分辨率的升档会增加cdn的播放成本,需客户侧谨慎评估,详细咨询火山引擎侧。 |
GroupID | String | 是 | 7304704552752808499 | 内容ID。 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
Abstract | String | 内容摘要。 | |
ArticleUrl | String | https://open.toutiao.com/a7304704552752808499/?a_t=AT6zTZuXzffxxxamerBKVv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BhZy1qxxxRKyi&form_scen=FROM_ARTICLE&group_id=7304704552752808499&item_id=7304704552752808499&label=article&req_id=202405221151476EEB7F859xxxD29946D9&utm_campaign=open&utm_medium=webview&utm_source=xxx_default_content" | 详情页H5页面。
|
GroupId | String | 7304704552752808499 | 内容id。 |
Title | String | 标题 | 内容标题 |
PublishTime | Long | 1700759062 | 内容发布时间,10位时间戳,单位:秒。 |
ShareUrl | String | https://open.toutiao.com/a7304704552752808499/?a_t=AT6zTZuXzffKpxxxerBKVv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BhZxxxRKyi&form_scen=FROM_ARTICLE&group_id=7304704552752808499&label=share&req_id=202405221151476EExxx8591E1D29946D9&utm_campaign=open&utm_medium=webview&utm_source=xxx_default_content | 分享页H5页面。 |
ShareCount | Long | 1000 | 内容分享数。 |
HasVideo | Boolean | true | 内容是否包含视频。
|
VideoWatchCount | Long | 500 | 视频观看量,当HasVideo为true时,返回此字段。 |
DiggCount | Long | 500 | 内容点赞数。 |
CommentUrl | String | https://open.toutiao.com/a7304704552752808499/comment/?a_t=AT6zTZuXzffKpQamerxxxv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BhZyxxxRKyi&form_scen=FROM_ARTICLE&group_id=7304704552752808499&label=share&req_id=2024052211514xxxEB7F8591E1D29946D9&utm_source=xxx_default_content | 评论H5页面。 |
CommentCount | Long | 500 | 内容评论数。 |
DiggStatus | Boolean | false | 点赞状态。
|
ArticleType | String | 图文 | 内容体裁。 |
CoverMode | Integer | 1 | 封面类型。 |
VideoDetail | VideoDetail | 视频资源,当HasVideo为true时,返回此字段。 | |
CoverImages | Array of Image | 封面图列表。 | |
UserInfo | UserInfo | 作者信息。 | |
ContentImageList | Array of Image | 正文图片列表,当内容体裁是图文时,返回此字段。 说明
|
GET /?Action=SingleArticleV2&Version=2021-01-01&ApiVersion=4&Partner=demo_default_content&AccessToken=AT6zTZuXzffKpQamerBKVv8mp94LRxxxdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&GroupID=7304704552752808499 HTTP/1.1 Host: https://mercury.volcengineapi.com/?Action=SingleArticleV2&Version=2021-01-01 X-Date: 20240522T064902Z Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240522/cn-north-1/content/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
{ "ResponseMetadata": { "RequestId": "2024052214492200405412104008D606", "Action": "SingleArticleV2", "Version": "2021-01-01", "Service": "content", "Region": "cn-north-1" }, "Result": { "Abstract": "-", "ArticleUrl": "https://open.toutiao.com/a7304704552752808499/?a_t=AT6zTZuXzffxxxamerBKVv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BhZy1qxxxRKyi&form_scen=FROM_ARTICLE&group_id=7304704552752808499&item_id=7304704552752808499&label=article&req_id=202405221151476EEB7F859xxxD29946D9&utm_campaign=open&utm_medium=webview&utm_source=xxx_default_content\"", "GroupId": "7304704552752808499", "Title": "标题", "PublishTime": 1700759062, "ShareUrl": "https://open.toutiao.com/a7304704552752808499/?a_t=AT6zTZuXzffKpxxxerBKVv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BhZxxxRKyi&form_scen=FROM_ARTICLE&group_id=7304704552752808499&label=share&req_id=202405221151476EExxx8591E1D29946D9&utm_campaign=open&utm_medium=webview&utm_source=xxx_default_content", "ShareCount": 1000, "HasVideo": true, "VideoWatchCount": 500, "DiggCount": 500, "CommentUrl": "https://open.toutiao.com/a7304704552752808499/comment/?a_t=AT6zTZuXzffKpQamerxxxv8mp94LR2ARdNJBp2BT86GrLpa3brqLmscGCUipuJNh2piKTT12&biz_log=BhZyxxxRKyi&form_scen=FROM_ARTICLE&group_id=7304704552752808499&label=share&req_id=2024052211514xxxEB7F8591E1D29946D9&utm_source=xxx_default_content", "CommentCount": 500, "DiggStatus": true, "ArticleType": "图文", "CoverMode": 1, "VideoDetail": { "VideoDuration": 2230.115, "VideoList": [ { "Definition": "360p", "Height": 360, "Width": 640, "Url": "http://mercury.snssdk.com/video/url/?param=ZvBxCXxxxyK2je&partner=xxx_default_content&version=2&trans_vdata_to_content=1" } ] }, "CoverImages": [ { "Url": "https://p6-open-sign.byteimg.com/tos-cn-i-pk90l89vgd/1c6a1776374c4486a46a5a5cbb145ffa~tplv-tt-cut:3216:1810.jpeg?scene=content&x-expires=1747815830&x-signature=ElLytAjeIfSe2O2WkFMqOBY2VUw%3D", "Width": 3216, "Height": 1810 } ], "UserInfo": { "AvatarUrl": "-", "Description": "-", "HomePage": "-", "Name": "-", "Follow": true, "FollowerCount": 0, "UserId": "-", "UserVerified": true, "VerifiedContent": "-" }, "ContentImageList": [ { "Url": "https://p6-open-sign.byteimg.com/tos-cn-i-pk90l89vgd/1c6a1776374c4486a46a5a5cbb145ffa~tplv-tt-cut:3216:1810.jpeg?scene=content&x-expires=1747815830&x-signature=ElLytAjeIfSe2O2WkFMqOBY2VUw%3D", "Width": 3216, "Height": 1810 } ] } }
您可访问公共错误码,获取更多错误码信息。