cURL 示例

概述

本指南提供可直接使用的 cURL 命令，用于通过 ExoClick API 进行身份验证和创建广告系列。所有示例根据端点要求使用标准 JSON 或 Form-Data 格式。

身份验证（登录）

你可以使用账户凭据或永久 API Token 进行身份验证。两者都会返回一个临时 Bearer Token，供后续所有请求使用。

使用用户名和密码登录

curl -X POST "https://api.exoclick.com/v2/login" \
     -H "Content-Type: application/json" \
     -d '{
       "username": "YOUR_USERNAME",
       "password": "YOUR_PASSWORD"
     }'

使用 API Token 登录

如果你在 ExoClick 仪表板（个人资料 > API Tokens）中生成了令牌，请使用此方式。

curl -X POST "https://api.exoclick.com/v2/login" \
     -H "Content-Type: application/json" \
     -d '{
       "api_token": "YOUR_API_TOKEN"
     }'

300x250 横幅广告系列创建流程

请严格按照以下步骤顺序操作。注意最后几步中从 JSON 切换为 Form-Data。

1

创建落地页 URL（素材库）

注册你的目标网址。

格式： JSON

curl -X POST "https://api.exoclick.com/v2/library/url" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://your-landing-page.com"
     }'

结果： 保存返回的 "id" （例如， 6512406).

2

上传图片（素材库）

注册你的创意素材。图片必须严格为 300x250。

格式： 表单数据

curl -X POST "https://api.exoclick.com/v2/library/file" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "file=@/path/to/your/image_300x250.jpg" \
     -F "type=image"

结果： 保存返回的 "id" （例如， 6884966).

3

创建广告系列外壳

设置定向、预算和 img_banner 模板。

格式： JSON

curl -X POST "https://api.exoclick.com/v2/campaigns" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Banner 300x250",
  "status": 0,
  "advertiser_ad_type": 0,
  "media_storage_template": "img_banner",
  "size": "300x250",
  "categories": { "type": "targeted", "elements": [97, 98, 99] },
  "countries": {
    "type": "targeted",
    "elements": [{ "country": "USA", "regions": [0] }]
  },
  "pricing": { "model": 4, "price": 300 },
  "start_date": "2026-03-02",
  "daily_limit_type": 1,
  "max_daily_budget": 2000,
  "budget_delivery_mode": 1,
  "run_on_responsive_zones": 1
}'

结果： 保存返回的 "id" （例如， 8140060).

4

添加变体

将 URL（步骤 1）和图片（步骤 2）链接到广告系列（步骤 3）。

格式： 表单数据

curl -X POST "https://api.exoclick.com/v2/campaigns/8140060/variation" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "id_library_url=6512406" \
     -F "id_library_file=6884966" \
     -F "active=1"

每一步返回的所有 ID 都必须保存并用于后续请求。记得将 YOUR_TOKEN、文件路径和 ID 替换为你的实际值。