本文档介绍内容洞察数据的图片信息获取接口的调用方式。
内容洞察的内容数据在客户场景使用时,客户业务会需要内容的图片信息,因此,内容洞察提供图片获取接口,客户侧可根据业务需要,通过内容ID,获取内容的图片地址信息。
备注:
接口调用前置操作,详见:调用指南
说明
图片链接有效时间6小时,过期后可重新调用接口获取新链接。
名称 | 内容 |
---|---|
接口地址 | /openapi/resource/image/cover |
请求方式 | GET |
是否需要鉴权 | 是 |
Header请求参数
字段 | 类型 | 是否必填 | 说明 |
---|---|---|---|
X-Insight-Biz-Name | string | 是 | 业务名称,见「数据流管理」-API配置-「账号ID」 |
X-Insight-Access-Token | string | 是 | 访问凭证,获取方式调用指南 |
Content-Type | string | 是 | 'application/json' |
Query请求参数
字段 | 类型 | 是否必填 | 说明 |
---|---|---|---|
post_id | string | 必填,post_id/origin_id二选一 | 发文ID |
origin_id | string | 抖音原始ID |
字段 | 类型 | 说明 | |
---|---|---|---|
status | int | 0为成功 | |
message | string | 返回错误信息 | |
data | main_url | string | 图片访问链接 |
backup_url | string | 图片访问链接[备用] |
请求示例
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": "", // 图片访问链接(备用) } }