You need to enable JavaScript to run this app.
导航
内容定制
  • 文档首页
    • /
  • 内容定制

获取内容详情

最近更新时间：2023.09.25 16:53:59

首次发布时间：2021.04.09 18:31:35

我的收藏

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

获取单条内容

通过group_id获取单条文章/视频内容

请求结构说明
请求域名stream-api.feedcoopapi.com
请求地址/article/single/info/
请求协议HTTP/HTTPS
请求方式GET

请求参数

参数描述类型是否必填说明
api_version接口版本int是固定传4
group_id内容idlong是“获取个性化内容”接口返回该字段
custom_video_definition指定视频分辨率String否枚举值:720p、540p、480p、360p、all。
默认不传时，短视频下发360p，小视频下发540p，传all时下发视频所有的分辨率。
如果请求的分辨率对于该视频不存在，则会自动降级一档返回内容作为兜底。
特别注意: 分辨率的升档会增加cdn的播放成本，需客户侧谨慎评估，详细咨询火山引擎侧。

响应参数

参数
描述
类型
说明
ret
响应结果
long

参见“错误码”说明，若文章已下架/删除，则返回22

req_id
本次请求标识
String
惟一标识本次请求，火山引擎侧使用该字段进行具体问题追踪和排查
msg
本次请求是否成功
String
success：成功
data
内容详情
JSONObject
内容的详细信息

请求示例

GET /article/single/info/?access_token=xxx&timestamp=1695624033&signature=xxx&nonce=123&partner=xxx&group_id=6852962028651610632 HTTP/1.1
Host: stream-api.feedcoopapi.com

响应示例

{
    "ret": 0,
    "msg": "success",
    "req_id": "20230925154924186D8FE7AA60F60E6376",
    "data": {
        "abstract": "xxx",
        "article_type": "短视频",
        "article_url": "https://open.toutiao.com/a6852962028651610632/?...",
        "comment_count": 23,
        "comment_url": "https://open.toutiao.com/a6852962028651610632/comment/?...",
        "cover_images": [
            {
                "url": "https://p3-open-sign.onewsimg.com/tos-cn-i-0004/2779ad99aca14c578463a4f6c485dbcf~tplv-tt-cut:1918:1078.jpeg?scene=content_consumer&x-expires=1758700164&x-signature=9ySxX5c2mmSyJUZwUyaQUBGpjw8%3D",
                "height": 1078,
                "width": 1918
            }
        ],
        "cover_mode": 1,
        "digg_count": 80,
        "group_id": "6852962028651610632",
        "has_video": true,
        "publish_time": 1595763120,
        "share_count": 15,
        "share_url": "https://partner.365yg.com/a6852962028651610632/?...",
        "title": "xxx",
        "user_info": {
            "avatar_url": "https://p6-open-sign.onewsimg.com/user-avatar/986054aa0790ff4e9e7dd6e1a824b052~tplv-obj.jpeg?scene=core&x-expires=1758700108&x-signature=HUwHg7j34srTSbr9bYhbef45QOc%3D",
            "description": "博极医源  惠及众生",
            "follow": false,
            "follower_count": 1847106,
            "home_page": "https://open.toutiao.com/u4056911501/?utm_source=server_sdk_demo_default_content&label=homepage&a_t=3117034000331234567c151&media_id=4056911501",
            "name": "健康一线",
            "user_id": 4056911501,
            "user_verified": true,
            "verified_content": "健康一线官方账号"
        },
        "video_watch_count": 18945,
        "video_detail": {
            "video_duration": 130.391,
            "video_list": [
              {
                    "url": "http://mercury.snssdk.com/video/url/?...",
                    "height": 360,
                    "width": 640,
                    "definition": "360p"
                }
            ]
        },
        "digg_status": false
    }
}
获取多条内容

传入多个group_id，批量的获取内容

请求结构说明
请求域名stream-api.feedcoopapi.com
请求地址/article/multi/info/
请求协议HTTP/HTTPS
请求方式GET

请求参数

参数描述类型是否必填说明
api_version接口版本int是固定传4
group_ids内容id列表String是最多支持20个group_id，多个group_id以英文逗号进行分隔
custom_video_definition指定视频分辨率String否枚举值:720p、540p、480p、360p、all。
默认不传时，短视频下发360p，小视频下发540p，传all时下发视频所有的分辨率。
如果请求的分辨率对于该视频不存在，则会自动降级一档返回内容作为兜底。
特别注意: 分辨率的升档会增加cdn的播放成本，需客户侧谨慎评估，详细咨询火山引擎侧。

响应参数

参数
描述
类型
说明
ret
响应结果
long

参见“错误码”说明

req_id
本次请求标识
String
惟一标识本次请求，火山引擎侧使用该字段进行具体问题追踪和排查
msg
本次请求是否成功
String
success：成功
data
内容详情
JSONObject
多条内容按照如下格式返回：
{
"7096032576028344868":{...},
"7096693595922661901": {...}
}；
若内容已下架，则接口自动过滤该条内容，不会返回

请求示例

GET /article/multi/info/?access_token=xxx&timestamp=1695624033&signature=xxx&nonce=123&partner=xxx&group_ids=7252312720853746208,7255361670145475087&api_version=4 HTTP/1.1
Host: stream-api.feedcoopapi.com

响应示例

{
    "ret": 0,
    "msg": "success",
    "req_id": "2023092516263614367F8CFC7457165FB0",
    "data": {
        "7252312720853746208": {
            "abstract": "xxx",
            "article_type": "图文内嵌视频",
            "article_url": "https://open.toutiao.com/a7252312720853746208/?...",
            "comment_url": "https://open.toutiao.com/a7252312720853746208/comment/?...",
            "cover_images": [
                {
                    "url": "https://p3-open-sign.onewsimg.com/tos-cn-i-tjoges91tu/Tj8eIJp3hhEiJF~tplv-tt-cut:983:549.jpeg?scene=content_consumer&x-expires=1758702396&x-signature=pba%2FiXtysWiPfwBefhgVvsuW5Rk%3D",
                    "height": 549,
                    "width": 983
                }
            ],
            "cover_mode": 1,
            "group_id": "7252312720853746208",
            "has_video": true,
            "publish_time": 1688560650,
            "share_url": "https://partner.365yg.com/a7252312720853746208/?...",
            "title": "xxx",
            "user_info": {
                "avatar_url": "https://p3-open-sign.onewsimg.com/user-avatar/9c0883d1a10b6ee419503f58ff978f1c~tplv-obj.jpeg?scene=core&x-expires=1758702302&x-signature=uYWa8lwnjYfuX6BJpvWd4J2yPNQ%3D",
                "description": "xxx",
                "follow": false,
                "follower_count": 47322138,
                "home_page": "https://open.toutiao.com/u52528956214/?...",
                "name": "四川观察",
                "user_id": 52528956214,
                "user_verified": true,
                "verified_content": "四川广播电视台新媒体官方账号"
            },
            "video_watch_count": 59,
            "video_detail": {
                "video_duration": 155.04,
                "video_list": [
                    {
                        "url": "http://mercury.snssdk.com/video/url/?...",
                        "height": 360,
                        "width": 640,
                        "definition": "360p"
                    }
                ]
            },
            "digg_status": false
        },
        "7255361670145475087": {
            "abstract": "xxx",
            "article_type": "图文",
            "article_read_count": 8393,
            "article_url": "https://open.toutiao.com/a7255361670145475087/?...",
            "comment_count": 12,
            "comment_url": "https://open.toutiao.com/a7255361670145475087/comment/?...",
            "cover_images": [
                {
                    "url": "https://p6-open-sign.onewsimg.com/tos-cn-i-qvj2lq49k0/708aab83ea6441cc91d0540c465de8b3~tplv-tt-cut:300:196.jpeg?scene=content_consumer&x-expires=1758702396&x-signature=2II4YkT%2FL8lSeMw%2FgOymTCFdIiM%3D",
                    "height": 196,
                    "width": 300
                }
            ],
            "cover_mode": 3,
            "digg_count": 21,
            "group_id": "7255361670145475087",
            "has_video": false,
            "publish_time": 1689270631,
            "share_count": 1,
            "share_url": "https://open.toutiao.com/a7255361670145475087/?...",
            "title": "xxx",
            "user_info": {
                "avatar_url": "https://p6-open-sign.onewsimg.com/user-avatar/c0fde4665c4bb17d32138f165e305999~tplv-obj.jpeg?scene=core&x-expires=1758702396&x-signature=%2FU51193gILY9kNvhQFIcoy%2FjB4Q%3D",
                "description": "",
                "follow": false,
                "follower_count": 18,
                "home_page": "https://open.toutiao.com/u1022997110732235/?...",
                "name": "hth健康蓝天0X1s",
                "user_id": 1022997110732235,
                "user_verified": false,
                "verified_content": ""
            },
            "digg_status": false
        }
    }
}