菜单

素材审核

注意接入Api前请先熟悉api签名机制(参考接口鉴权说明), 即Api请求样例中的一些http请求头的来源

1. 获取待审核素材列表

备注:只返回待审核的素材

1.1 请求URL

https://openapi.toponad.com/v1/creative_audit/list

1.2 请求方式

POST

1.3 请求参数

字段 类型 是否必传 备注
page Int N

页码,<=0 时默认 1

page_size Int N

每页条数,<=0 时默认 20,最大 1000

 

type Int N

素材类型:1=img_u, 2=icon_u, 3=video_u, 4=title, 5=desc, 6=cta

1.4 样例

请求样例:

curl --location --request POST 'https://openapi.toponad.com/v1/creative_audit/list' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 1,
    "page_size": 20,
    "type": 3
}'

返回样例:

{
    "total": 3,
    "list": [
        {
            "uuid": "3243242343242sd",
            "type": 1,
            "content": "http://baidu.456.jpg",
            "audit_status": 1,
            "log_time": 1773802149,
            "audit_time": 1773804705
        }
    ]
}

2. 批量更新素材审核状态

2.1 请求URL

https://openapi.toponad.com/v1/creative_audit/batch_update_status

2.2 请求方式

POST

2.3 请求参数

字段 类型 是否必传 备注
uuids array Y

字符串数组

audit_status Int Y

2=通过,3=不通过

2.4 样例

请求样例:

curl --location --request POST 'https://openapi.toponad.com/v1/creative_audit/batch_update_status' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uuids": [
        "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "z9y8x7w6v5u4t3s2r1q0p9o8n7m6l5k4"
    ],
    "audit_status": 2
}'

返回样例:

 {
        "updated": 2
  }

上一个
服务端回调规则管理
下一个
数据报表API
最近修改: 2026-03-23Powered by