服务端开放接口
  1. 检索
服务端开放接口
  • API调用指南
    • 01 API 调用流程
    • 02 通用参数
    • 03 通用错误码
  • 鉴权(访问令牌)
    • 01 获取访问令牌
      POST
    • 02 刷新访问令牌
      POST
  • 素材
    • 素材相关说明
    • 上传
      • 02 上传资源到云服务器
      • 01 获取上传文件临时令牌
      • 03 (case1)创建内容原子
      • 03 (case2)创建文本内容原子
      • 03 (case3)创建组合内容原子
      • 03 (case4)创建网页内容原子
      • 04 素材入库
      • 05上传附件
    • 检索
      • 素材动态格式及大小转换
      • 01 素材检索
      • 02 查询素材详情
      • 03 素材标签检索
      • 04 查询素材信息和所在组信息
      • 素材拉取
      • 回收站素材检索
    • 编辑
      • 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 素材检索
          POST
        • 02 查询素材详情
          POST
        • 03 查询文档类型素材的pageInfo
          POST
        • 04 查询素材名称和所在素材组
          POST
        • 05 查询素材列表
          POST
      • 编辑
        • 01 素材批量编辑
    • 素材组
      • 01 素材组检索
    • 用户
      • 01 查询用户列表
  • 日常测试
    • 晖致素材列表
  • 测试
    POST
  1. 检索

02 查询素材详情

POST
/open-api/standard/v1/query-detail-list
素材检索
注意
当前接口已进行升级,旧接口会陆续下线,请尽快升级到最新版。查看最新版>>查询素材详情
此接口通过素材ID集合获取素材详情

请求参数

Header 参数
Access-token
string 
必需
示例值:
90602578-927a-4479-b97e-1b1e2e0e4a7f
Token-type
string 
必需
示例值:
bearer
Content-Type
string 
必需
示例值:
application/json
x-asm-prefer-tag
string 
可选
默认值:
version-env-07
Body 参数application/json
token
string 
必需
param
object 
必需
materialIdList
array[integer]
素材ID集合
必需
permalink
boolean 
是否获取永久链接
可选
默认取值false,即返回的链接有消息为30天。
传true时,返回信息中以下字段为永久可访问链接(前置条件:需要联系管理员在素材库内先为当前素材组开启永久有效链接):
thumbnailSrc、downloadUrl、transformPreviewUrl。
示例
{
 "token": "", 
 "param": {"materialIdList":[81668]}
} 

示例代码

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/v1/query-detail-list' \
--header 'Access-token: 90602578-927a-4479-b97e-1b1e2e0e4a7f' \
--header 'Token-type: bearer' \
--header 'x-asm-prefer-tag: version-env-07' \
--header 'Content-Type: application/json' \
--data-raw '{
 "token": "", 
 "param": {"materialIdList":[81668]}
}'

返回响应

🟢200成功
application/json
Body
code
string 
必需
message
string 
必需
result
object 
必需
detail
array [object {18}] 
必需
示例
{
    "code": "0",
    "message": "处理成功",
    "result": {
        "detail": [
            {
                "duration": 754,
                "17b5049e87de43e2a83640ea10a683ea": null,
                "b5c4770aaf5c48258546396211061678": null,
                "414bfa1a074f4669ab557191caa78b9b": null,
                "extension": "PNG",
                "fileHeight": 2015,
                "downloadUrl": "https://test-cms-assets-1302259445.cos.ap-beijing.myqcloud.com/t1000001/6cb4b0191a6de2b8b8d7edd9e6e1e9f2.png?&sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDsdATXLuEKCuQmuoTt44rOfldFdomZ8SX%26q-sign-time%3D1665284386%3B1667318399%26q-key-time%3D1665284386%3B1667318399%26q-header-list%3Dhost%26q-url-param-list%3Dresponse-cache-control%3Bresponse-content-disposition%3Bresponse-content-type%3Bresponse-expires%26q-signature%3D3f07be48f0ccd3d697d847b49c6f3bded8ebb83a&response-cache-control=no-cache&response-content-disposition=attachment%3B%20filename%3D%22%25E5%25BF%2583%25E6%25B4%25BB700g%25E6%25A1%25B6%25E6%2595%2588%25E6%259E%259C%25E5%259B%25BE%2520%25E4%25BD%258E%25E8%2584%2582%2520%25E5%25B7%25A6%25281%2529.png%22%3B%20filename%2A%3Dutf-8%27%27%25E5%25BF%2583%25E6%25B4%25BB700g%25E6%25A1%25B6%25E6%2595%2588%25E6%259E%259C%25E5%259B%25BE%2520%25E4%25BD%258E%25E8%2584%2582%2520%25E5%25B7%25A6%25281%2529.png&response-expires=Sun%2C%2009%20Oct%202022%2012%3A59%3A46%20GMT&response-content-type=application%2Foctet-stream",
                "updateTime": 1664524533000,
                "f07cd85eaaf5481cb0d5b4532df0dc9d": null,
                "url": "https://test-cms-assets-1302259445.cos.ap-beijing.myqcloud.com/t1000001/6cb4b0191a6de2b8b8d7edd9e6e1e9f2.png?&sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDsdATXLuEKCuQmuoTt44rOfldFdomZ8SX%26q-sign-time%3D1665284386%3B1667318399%26q-key-time%3D1665284386%3B1667318399%26q-header-list%3Dhost%26q-url-param-list%3Dresponse-content-disposition%26q-signature%3D8697ad401e27c86950f5c2a880027d31331c62bf&response-content-disposition=inline",
                "expireTime": 1698163200000,
                "deb44cfca5584b08a7e47937475110f2": [
                    {
                        "title": "2022",
                        "value": "1631095263287",
                        "sort": 1,
                        "parentList": [],
                        "fullTitle": "2022",
                        "sortList": [
                            1
                        ]
                    }
                ],
                "size": 1659153,
                "bface1dca91d4473ae35640dc43e2a9d": null,
                "createTime": 1664524533000,
                "assetId": 1510296,
                "name": "心活700g桶效果图 低脂 左(1)",
                "createUser": 167284,
                "id": 10544,
                "APP_PUSH_ZONE": null,
                "046c95b313bc44b69fe5dc9b8f3003b8": null,
                "fileWidth": 1828,
                "thumbnailURL": "https://test-cms-assets-1302259445.cos.ap-beijing.myqcloud.com/t1000001/6cb4b0191a6de2b8b8d7edd9e6e1e9f2.png?imageMogr2/thumbnail/300x300&sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDsdATXLuEKCuQmuoTt44rOfldFdomZ8SX%26q-sign-time%3D1665284386%3B1667318399%26q-key-time%3D1665284386%3B1667318399%26q-header-list%3Dhost%26q-url-param-list%3Dresponse-content-disposition%26q-signature%3D8697ad401e27c86950f5c2a880027d31331c62bf&response-content-disposition=inline",
                "transformPreviewUrl": "https://assets-test-cdn.tezign.com/80159ff654b14124ba38c1d8ba82f581.png?Expires=2272274006399&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=FXSV9HerW%2FBe9VoALZ1J%2FANC%2B8k%3D&response-content-disposition=inline&yunCode=OSS&image_process=resize,s_300"
            }
        ]
    }
}
上一页
01 素材检索
下一页
03 查询文档类型素材的pageInfo
Built with