You need to enable JavaScript to run this app.
导航
图片获取接口
最近更新时间:2024.06.07 12:37:58首次发布时间:2024.01.11 10:56:24

本文档介绍内容洞察数据的图片信息获取接口的调用方式。

概述

内容洞察的内容数据在客户场景使用时,客户业务会需要内容的图片信息,因此,内容洞察提供图片获取接口,客户侧可根据业务需要,通过内容ID,获取内容的图片地址信息。

备注:
接口调用前置操作,详见:调用指南

说明

图片链接有效时间6小时,过期后可重新调用接口获取新链接。


请求接口

基本信息

名称内容
接口地址/openapi/resource/image/cover
请求方式GET
是否需要鉴权

请求参数

Header请求参数

字段类型是否必填说明
X-Insight-Biz-Namestring业务名称,见「数据流管理」-API配置-「账号ID」
X-Insight-Access-Tokenstring访问凭证,获取方式调用指南
Content-Typestring'application/json'

Query请求参数

字段类型是否必填说明
post_idstring必填,post_id/origin_id二选一发文ID
origin_idstring抖音原始ID

返回参数

字段类型说明
statusint0为成功
messagestring返回错误信息
datamain_urlstring图片访问链接
backup_urlstring图片访问链接[备用]

调用示例

请求示例

GET /openapi/resource/image/cover?post_id=<xxxxxxxx>

header:
X-Insight-Biz-Name: $biz_name
X-Insight-Access-Token: $token
Content-Type: application/json

返回示例

{
    "status":  0,
    "message": "succeed",
    "data": {
        "main_url":   "", // 图片访问链接
        "backup_url": "", // 图片访问链接(备用)
    }
}