服务端开放接口
  1. 检索
服务端开放接口
  • API调用指南
    • 01 API 调用流程
    • 02 通用参数
    • 03 通用错误码
  • 鉴权(访问令牌)
    • 01 获取访问令牌
      POST
    • 02 刷新访问令牌
      POST
  • 素材
    • 素材相关说明
    • 上传
      • 02 上传资源到云服务器
      • 01 获取上传文件临时令牌
      • 03 (case1)创建内容原子
      • 03 (case2)创建文本内容原子
      • 03 (case3)创建组合内容原子
      • 03 (case4)创建网页内容原子
      • 04 素材入库
      • 05上传附件
    • 检索
      • 素材动态格式及大小转换
      • 01 素材检索
        POST
      • 02 查询素材详情
        POST
      • 03 素材标签检索
        POST
      • 04 查询素材信息和所在组信息
        POST
      • 素材拉取
        POST
      • 回收站素材检索
        POST
    • 编辑
      • 01 素材批量编辑
      • 02 删除素材
      • 03 删除素材标签
      • 04 素材内容编辑
  • 联动打标
    • 联动打标指南
    • 01 获取已配置的关联字段
      GET
    • 02 对指定素材重新进行联动打标
      POST
    • 03 刷新标签关联关系
      POST
  • 素材组
    • 检索
      • 01 素材组检索
      • 02 获取素材组内素材链接
    • 创建
      • 01 创建素材组
    • 编辑
      • 01 删除素材组
      • 02 素材组新增素材
      • 03 素材组移除素材
  • 元数据(Metadata)
    • 检索
      • 01 查询metadata标签
      • 02 查询筛选模板元数据
      • 03 查询编辑模板元数据
    • 编辑
      • 02 删除metadata标签
      • 01 新增metadata标签
      • 03 更新metadata标签
  • 内容分发
    • 01 分发看板
      • 01 分页查询内容
      • 02 获取内容详情
      • 03 根据内容ID列表获取内容统计值
      • 04 批量查询内容详情
      • 05 查询内容区块渠道标签配置
      • 06 查询内容模块点位信息
      • 07 查询内容模块基础信息(包含导航信息)
      • 08 批量添加Portal协作者
      • 09 新增/更改 Portal
      • 10 移除Portal
      • 11 批量保存/编辑Block
      • 12 根据人群标签获取内容标签
    • 02 内容中心
      • 内容中心业务说明
      • 01 分页查询内容
      • 02 查询内容详情
    • 03 私域中心
      • 01 人群包
        • 01 查询人群包列表
        • 02 添加人群包
        • 03 修改人群包
        • 04 删除人群包
        • 05 向人群包中添加人群
        • 06 根据人群包ID查询人群信息
        • 07 根据人群包删除人群
      • 02 营销计划
        • 01 新建私域计划
        • 02 修改私域计划
        • 03 删除私域计划
      • 03 营销任务
        • 01 新建私域任务
        • 02 修改私域任务
        • 03 删除私域任务
        • 04 创建企微群发消息
      • 04 营销任务数据
        • 01 客户与内容互动数据
        • 02 群发失败原因详情
        • 03 群发转发任务报表
    • 04社媒分发
      • 获取统计数据
      • 获取热门内容
  • 消息
    • 邮件/短信
      • 01 消息统一分发
    • 小铃铛
      • 检索
        • 01 查询消息列表
      • 编辑
        • 01 新增小铃铛消息
        • 02 消息设置已读
    • 待办事项
      • 检索
        • 01 查询待办消息列表
      • 编辑
        • 01 设置待办消息为已完成
  • 租户基础信息
    • 01 查询租户配置
    • 02 租户检索
  • 用户信息
    • 用户
      • 01 用户检索
      • 02 通过邮箱/手机获取用户信息
    • 部门
      • 01 部门检索
    • 角色
      • 01 检验用户角色权限
  • 埋点
    • 01 服务端埋点上报
    • 02 客户端埋点上报
    • 03 查询埋点数据
  • 审批中心
    • 01 获取审批模板
    • 02 审批项目获取
    • 03 查询审批任务列表
    • 04 发起审批
    • 05 发起入库审批(外部)
  • 规则引擎
    • 01 匹配规则
  • 冷库归档
    • 素材组
      • 检索
        • 获取根素材组信息
        • 获取非根素材组信息
    • 素材
      • 上传
        • 上传&入库流程详解
        • 上传资源到云服务器
        • 上传资源到云服务器
        • 归档库上传
      • 检索
        • 素材查询
  • 客户端开放接口
    • 接口验签
    • 内容分发看板
      • 01 查询内容区块信息(不推荐)
      • 02 搜索内容区块中内容(不推荐)
      • 03 获取单个内容详情(不推荐)
  • 历史版本(不推荐)
    • 素材
      • 上传
        • 01 获取上传临时令牌
        • 02 创建资源
        • 03 素材入库
      • 检索
        • 01 素材检索
        • 02 查询素材详情
        • 03 查询文档类型素材的pageInfo
        • 04 查询素材名称和所在素材组
        • 05 查询素材列表
      • 编辑
        • 01 素材批量编辑
    • 素材组
      • 01 素材组检索
    • 用户
      • 01 查询用户列表
  • 日常测试
    • 晖致素材列表
  • 测试
    POST
  1. 检索

02 查询素材详情

POST
/open-api/standard/v2/asset/detail-list
查询素材详情
查询素材详情

请求参数

Header 参数
Access-token
string 
必需
示例值:
db28c148-24c0-452d-80e9-c4797d991a22
Token-type
string 
必需
示例值:
bearer
x-open-api-user
string 
必需
示例值:
xxx@tezign.com
Content-Type
string 
必需
示例值:
application/json
x-asm-prefer-tag
string 
可选
默认值:
version-env-07
Body 参数application/json
token
string 
必需
param
object 
必需
assetIdList
array[integer]
素材id集合
必需
permalink
boolean 
是否获取永久链接
可选
默认取值false,即返回的链接有效期为30天。 - 传true时,返回信息中以下字段为永久可访问链接(前置条件:需要联系管理员在素材库内先为当前素材组开启永久有效链接):thumbnailSrc、downloadUrl、transformPreviewUrl。
示例
{
    "token": "a022a268-2148-41b8-8e00-2a5feee5cc70",
    "param": {
        "assetIdList": [
            4766668
        ]
    }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open-auth.tezign.com/open-api/standard/v2/asset/detail-list' \
--header 'Access-token: db28c148-24c0-452d-80e9-c4797d991a22' \
--header 'Token-type: bearer' \
--header 'x-open-api-user: xxx@tezign.com' \
--header 'x-asm-prefer-tag: version-env-07' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "a022a268-2148-41b8-8e00-2a5feee5cc70",
    "param": {
        "assetIdList": [
            4766668
        ]
    }
}'

返回响应

🟢200成功
application/json
Body
code
string 
必需
message
string 
必需
result
object 
必需
detail
array [object {20}] 
必需
示例
{
    "code": "0",
    "message": "success",
    "result": {
        "detail": [
            {
                "approvalStatus": 1,
                "materialOrigin": {
                    "isDownload": 0,
                    "riskLevel": -1,
                    "watermark": "0",
                    "updateUser": -1,
                    "templateGenerateCount": 0,
                    "updateTime": 1699584559000,
                    "stickTop": 0,
                    "dummy": 2,
                    "assetTagStatus": 0,
                    "createTime": 1699584545000,
                    "maplexStatus": 0,
                    "createUser": 1,
                    "isDam": 0,
                    "coreId": 417132,
                    "id": 416405,
                    "importUrl": "",
                    "scenarioVisibility": "ALL_VISIBLE",
                    "ruleCheckStatusCode": 201,
                    "analysisStatus": 0,
                    "ruleCheckStatus": "UNSUPPORTED_FORMAT",
                    "status": 0
                },
                "extension": "res_group",
                "importance": 3,
                "collectionInfo": [],
                "updateUser": 1,
                "updateTime": 1699584545000,
                "tags": "",
                "authInfoList": [
                    {
                        "unitType": 3,
                        "unitId": 1,
                        "unitName": "DAM Manager",
                        "dataRoleId": 4,
                        "dataRoleName": "所有者",
                        "dataRoleCode": "ownerRole",
                        "editable": 1,
                        "materialId": 417132
                    }
                ],
                "customerLifeCycleRuleTagCode": "20220401005383",
                "size": 36,
                "createTime": 1699584545000,
                "subResList": [
                    {
                        "thumbnailOriginWidth": null,
                        "extension": "content_text",
                        "downloadUrl": null,
                        "picNum": null,
                        "uniMd5": null,
                        "fileFormatType": "content_text",
                        "thunder": null,
                        "title": "随便写点",
                        "type": "content_text",
                        "duration": null,
                        "pdfStatus": 0,
                        "path": "496ac9375ab7175f162bf42c7fb9a47a",
                        "transformPreviewUrl": null,
                        "thunderOrigin": null,
                        "id": 3837851,
                        "publicRead": false,
                        "thumbnailAssetId": null,
                        "height": null,
                        "aliasName": "随便写点",
                        "thumbnailOriginHeight": null,
                        "iconThunder": null,
                        "textNum": null,
                        "damId": null,
                        "resType": 1,
                        "keyName": "496ac9375ab7175f162bf42c7fb9a47a",
                        "iconAssetId": null,
                        "updateTime": 1699584510000,
                        "originalUrl": null,
                        "videoNum": null,
                        "analysisAssetIds": null,
                        "baseTextUpdateTime": 1699584510000,
                        "url": null,
                        "size": 12,
                        "createTime": 1699584510000,
                        "name": "496ac9375ab7175f162bf42c7fb9a47a",
                        "width": null,
                        "wordNum": 4,
                        "urlWithParam": null,
                        "assetStatus": 0,
                        "baseText": "随便写点"
                    },
                    {
                        "thumbnailOriginWidth": null,
                        "extension": "content_rtf",
                        "downloadUrl": null,
                        "picNum": null,
                        "uniMd5": null,
                        "fileFormatType": "content_rtf",
                        "thunder": "https://wxproxy.yiban.io/sz_mmbiz_png/mT7LicyR7mhYdZF64v4I8iaN7ibOK6m0RE2gsuACwYjt1dj46hqggDtM8sTCNoGlG8ibZvp2fQ6fvCFD4QZq6YUgRQ/0",
                        "title": " 不咋shark啊师傅啊师傅 ",
                        "type": "content_rtf",
                        "duration": null,
                        "pdfStatus": 0,
                        "path": "b2d4c2f7627c861d7976a06ca1eef2ec",
                        "transformPreviewUrl": null,
                        "thunderOrigin": null,
                        "id": 3837852,
                        "publicRead": false,
                        "thumbnailAssetId": null,
                        "height": null,
                        "aliasName": " 不咋shark啊师傅啊师傅 ",
                        "thumbnailOriginHeight": null,
                        "iconThunder": null,
                        "textNum": null,
                        "damId": null,
                        "resType": 1,
                        "keyName": "b2d4c2f7627c861d7976a06ca1eef2ec",
                        "iconAssetId": null,
                        "updateTime": 1699584524000,
                        "originalUrl": null,
                        "videoNum": null,
                        "analysisAssetIds": null,
                        "baseTextUpdateTime": 1699584524000,
                        "url": null,
                        "size": 8744,
                        "createTime": 1699584524000,
                        "name": "b2d4c2f7627c861d7976a06ca1eef2ec",
                        "width": null,
                        "wordNum": null,
                        "urlWithParam": null,
                        "assetStatus": 0,
                        "baseText": "<p>文章的html</p>"
                    },
                    {
                        "thumbnailOriginWidth": 1024,
                        "extension": "png",
                        "downloadUrl": "https://itg-tezign-files.tezign.com/t5/MTY5OTUyNTQ4MDY0OGEzNWU1M2Y2LWI1NmYtNDA0Ny1iNDZh.png?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=6WKoOjN6Umqm0EHXVoZ1qPz7l3I%3D&response-content-disposition=attachment%3B%20filename%3D%22%25E8%2596%25AF%25E6%259D%25A1-%25E5%258D%2596%25E7%2582%25B93.png%22%3B%20filename%2A%3Dutf-8%27%27%25E8%2596%25AF%25E6%259D%25A1-%25E5%258D%2596%25E7%2582%25B93.png&response-content-type=application%2Foctet-stream",
                        "picNum": null,
                        "uniMd5": "5e2e8b234321d5675f4a1955659577ad",
                        "fileFormatType": "picture",
                        "thunder": "https://itg-tezign-files.tezign.com/t5/MTY5OTUyNTQ4MDY0OGEzNWU1M2Y2LWI1NmYtNDA0Ny1iNDZh.png?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=HBKHJj79duvq2%2FJoSDOZbwiDdnw%3D&response-content-disposition=inline&image_process=resize,l_300",
                        "title": null,
                        "type": "image/png",
                        "duration": null,
                        "pdfStatus": 0,
                        "path": "t5/MTY5OTUyNTQ4MDY0OGEzNWU1M2Y2LWI1NmYtNDA0Ny1iNDZh.png",
                        "transformPreviewUrl": "https://assets-cdn.tezign.com/t5/MTY5OTUyNTQ4MDY0OGEzNWU1M2Y2LWI1NmYtNDA0Ny1iNDZh.png?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=HBKHJj79duvq2%2FJoSDOZbwiDdnw%3D&response-content-disposition=inline&yunCode=OSS&image_process=resize,s_300",
                        "thunderOrigin": null,
                        "id": 3837744,
                        "publicRead": false,
                        "thumbnailAssetId": null,
                        "height": 1024,
                        "aliasName": null,
                        "thumbnailOriginHeight": 1024,
                        "iconThunder": null,
                        "textNum": null,
                        "damId": null,
                        "resType": 0,
                        "keyName": "MTY5OTUyNTQ4MDY0OGEzNWU1M2Y2LWI1NmYtNDA0Ny1iNDZh.png",
                        "iconAssetId": null,
                        "updateTime": 1699525484000,
                        "originalUrl": "https://itg-tezign-files.tezign.com/t5/MTY5OTUyNTQ4MDY0OGEzNWU1M2Y2LWI1NmYtNDA0Ny1iNDZh.png?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=HBKHJj79duvq2%2FJoSDOZbwiDdnw%3D&response-content-disposition=inline",
                        "videoNum": null,
                        "analysisAssetIds": null,
                        "baseTextUpdateTime": null,
                        "url": "https://itg-tezign-files.tezign.com/t5/MTY5OTUyNTQ4MDY0OGEzNWU1M2Y2LWI1NmYtNDA0Ny1iNDZh.png?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=HBKHJj79duvq2%2FJoSDOZbwiDdnw%3D&response-content-disposition=inline",
                        "size": 660110,
                        "createTime": 1699525483000,
                        "name": "薯条-卖点3.png",
                        "width": 1024,
                        "wordNum": null,
                        "urlWithParam": "https://itg-tezign-files.tezign.com/t5/MTY5OTUyNTQ4MDY0OGEzNWU1M2Y2LWI1NmYtNDA0Ny1iNDZh.png?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=HBKHJj79duvq2%2FJoSDOZbwiDdnw%3D&response-content-disposition=inline",
                        "assetStatus": 1,
                        "baseText": null
                    },
                    {
                        "thumbnailOriginWidth": 1920,
                        "extension": "mp4",
                        "downloadUrl": "https://itg-tezign-files.tezign.com/t5/MTY5OTUyOTgzMjYzNmNlMDE1MDdlLTY0OWYtNDMyYS1hYTVh.mp4?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=Jwn%2Fkbn0CzSijBBONgyFDSuu8pU%3D&response-content-disposition=attachment%3B%20filename%3D%22%25E8%25A7%2586%25E9%25A2%2591.mp4%22%3B%20filename%2A%3Dutf-8%27%27%25E8%25A7%2586%25E9%25A2%2591.mp4&response-content-type=application%2Foctet-stream",
                        "picNum": null,
                        "uniMd5": "478e0ab1fc5460e3155213925a00a978",
                        "fileFormatType": "video",
                        "thunder": "https://itg-tezign-files.tezign.com/t5/mp4/MTY5OTUyOTgzMjYzNmNlMDE1MDdlLTY0OWYtNDMyYS1hYTVh_1280P.mp4?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=ZSgZZcs1o%2FWHgp49artNpc9nJ1w%3D&response-content-disposition=inline&x-oss-process=video%2Fsnapshot%2Cm_fast%2Ct_1000%2Cw_300",
                        "title": null,
                        "type": "video/mp4",
                        "duration": 391967,
                        "pdfStatus": 0,
                        "path": "t5/MTY5OTUyOTgzMjYzNmNlMDE1MDdlLTY0OWYtNDMyYS1hYTVh.mp4",
                        "transformPreviewUrl": "https://assets-cdn.tezign.com/t5/mp4/MTY5OTUyOTgzMjYzNmNlMDE1MDdlLTY0OWYtNDMyYS1hYTVh_1280P.mp4?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=5H9l822PGZjzkfTshm47CWlJTeE%3D&response-content-disposition=inline&yunCode=OSS",
                        "thunderOrigin": "https://itg-tezign-files.tezign.com/t5/mp4/MTY5OTUyOTgzMjYzNmNlMDE1MDdlLTY0OWYtNDMyYS1hYTVh_1280P.mp4?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=ZSgZZcs1o%2FWHgp49artNpc9nJ1w%3D&response-content-disposition=inline&x-oss-process=video%2Fsnapshot%2Cm_fast%2Ct_1000%2Cw_300",
                        "id": 3837777,
                        "publicRead": false,
                        "thumbnailAssetId": null,
                        "height": 1080,
                        "aliasName": null,
                        "thumbnailOriginHeight": 1080,
                        "iconThunder": null,
                        "textNum": null,
                        "damId": null,
                        "resType": 0,
                        "keyName": "MTY5OTUyOTgzMjYzNmNlMDE1MDdlLTY0OWYtNDMyYS1hYTVh.mp4",
                        "iconAssetId": null,
                        "updateTime": 1699529875000,
                        "originalUrl": "https://itg-tezign-files.tezign.com/t5/MTY5OTUyOTgzMjYzNmNlMDE1MDdlLTY0OWYtNDMyYS1hYTVh.mp4?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=PQepS5txlI3f4jU%2Fz2vyUIyJkKM%3D&response-content-disposition=inline",
                        "videoNum": null,
                        "analysisAssetIds": null,
                        "baseTextUpdateTime": null,
                        "url": "https://itg-tezign-files.tezign.com/t5/mp4/MTY5OTUyOTgzMjYzNmNlMDE1MDdlLTY0OWYtNDMyYS1hYTVh_1280P.mp4?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=5H9l822PGZjzkfTshm47CWlJTeE%3D&response-content-disposition=inline",
                        "size": 673751895,
                        "createTime": 1699529862000,
                        "name": "视频.mp4",
                        "width": 1920,
                        "wordNum": null,
                        "urlWithParam": "https://itg-tezign-files.tezign.com/t5/MTY5OTUyOTgzMjYzNmNlMDE1MDdlLTY0OWYtNDMyYS1hYTVh.mp4?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=PQepS5txlI3f4jU%2Fz2vyUIyJkKM%3D&response-content-disposition=inline",
                        "assetStatus": 1,
                        "baseText": null
                    }
                ],
                "name": "测试组合-1110",
                "wordNum": 4,
                "assetElementId": 3837853,
                "createUser": 1,
                "id": 417132,
                "baseText": "随便写点",
                "thumbnailUrL": "https://itg-tezign-files.tezign.com/t5/MTY5OTUyNTQ4MDY0OGEzNWU1M2Y2LWI1NmYtNDA0Ny1iNDZh.png?Expires=1704124799&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=HBKHJj79duvq2%2FJoSDOZbwiDdnw%3D&response-content-disposition=inline&image_process=resize,l_300",
                "customerLifeCycleRule": "0"
            }
        ]
    }
}
修改于 2024-05-17 02:54:42
上一页
01 素材检索
下一页
03 素材标签检索
Built with