素材列表

v1.0.0

Base URLs:

• 正式环境 1: https://ad.adintl.cn/openApi

素材列表接口

更新日志

时间	说明
2025-04-09	新增接口

POST

/admMaterialList

请求参数

名称	位置	类型	必选	说明
userName	body	string	是	账号
authCode	body	string	是	授权码，见章鱼移动广告 SAAS 平台 右上角授权码获取
slotIds	body	string	选填	屏蔽渠道 ID,多个英文逗号分割
date	body	string	必填	仅能查最近 7 天素材
pageNo	requestUrl	int	选填	默认 1，分页数
pageSize	requestUrl	int	选填	默认 10，每页数据数

说明，如果 slotId 为空则查询当前账号下所有渠道的相应素材 如果 slotId 不为空则查询当前账号下指定渠道的相应素材

请求参数 json 格式，示例

{
  "date": "2025-04-09", // 仅能查最近7天素材
  "slotIds": "1234,2345",
  "userName": "aaa",
  "authCode": "ec42e778e59f2f7beface5fdf169b4d8"
}

返回内容

返回数据结构

序号	名称	类型	必选	说明
1	success	boolean	是	状态
2	message	string	是	消息内容
3	code	int	是	状态码，200 成功，其他失败
4	result	object	否	无异议
4.1	total	int	否	数据总数
4.2	data	object	否	数据
4.2.1	slotid	string	否	渠道 ID
4.2.2	url	string	否	素材地址
4.2.3	title	string	否	素材标题
4.3	pageNo	int	否	页数
4.4	pageSize	int	否	每页数据个数
5	timestamp	long	是	毫秒时间戳

返回示例

{
  "success": true,
  "message": "success",
  "code": 200,
  "result": {
    "total": 1,
    "data": [
      {
        "title": "素材标题",
        "slotid": 1234,
        "url": "https://asdf1234.com/asdf.png"
      }
    ],
    "pageNo": 1,
    "pageSize": 10
  },
  "timestamp": 1744182793740
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功
500	false	失败

请求示例

CURL

curl --location --request POST 'https://ad.adintl.cn/openApi/admMaterialList?pageNo=1&pageSize=10' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Host: ad.adintl.cn' \
--header 'Connection: keep-alive' \
--data-raw '{
  "date": "2025-04-09",
  "userName": "aaaa",
  "authCode": "1234"
}'

java

OkHttpClient client = new OkHttpClient().newBuilder()
   .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"date\": \"2025-04-09\",\n  \"userName\": \"aaaa\",\n  \"authCode\": \"1234\"\n}");
Request request = new Request.Builder()
   .url("https://ad.adintl.cn/openApi/admMaterialList?pageNo=1&pageSize=10")
   .method("POST", body)
   .addHeader("User-Agent", "Apifox/1.0.0 (https://apifox.com)")
   .addHeader("Content-Type", "application/json")
   .addHeader("Accept", "*/*")
   .addHeader("Host", "ad.adintl.cn")
   .addHeader("Connection", "keep-alive")
   .build();
Response response = client.newCall(request).execute();