Postman 示例

概述

本指南提供了使用 Postman 通过 ExoClick API 进行身份验证和创建广告系列的分步说明。所有示例都指定了每个端点所需的请求类型、请求头和正文格式。

身份验证（登录）

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

使用用户名和密码登录

请求类型： POST URL： https://api.exoclick.com/v2/login

请求头：

Content-Type: application/json

请求体（原始 JSON）：

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD"
}

使用 API 令牌登录

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

请求类型： POST URL： https://api.exoclick.com/v2/login

请求头：

Content-Type: application/json

请求体（原始 JSON）：

{
  "api_token": "YOUR_API_TOKEN"
}

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

请按以下步骤的准确顺序进行。请注意在最后几步中从 JSON 切换到表单数据（Form-Data）。

1

创建落地页 URL（库）

注册您的目标 URL。标准横幅需要一个 id_library_url.

请求类型： POST URL： https://api.exoclick.com/v2/library/url

请求头：

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

请求体（原始 JSON）：

{
  "url": "https://your-landing-page.com"
}

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

2

上传图片（库）

注册您的创意素材。图片必须正好为 300x250。

请求类型： POST URL： https://api.exoclick.com/v2/library/file

请求头：

Authorization: Bearer YOUR_TOKEN

请求体（form-data）：

键	类型	值
file	文件	选择您的图片文件（300x250）
type	文本	image

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

3

创建广告系列框架

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

请求类型： POST URL： https://api.exoclick.com/v2/campaigns

请求头：

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

请求体（原始 JSON）：

{
  "name": "Banner 300x250 Production",
  "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）。

请求类型： POST URL： https://api.exoclick.com/v2/campaigns/8140060/variation （替换 8140060 为步骤 3 中您实际的广告系列 ID）

请求头：

Authorization: Bearer YOUR_TOKEN

请求体（form-data）：

键	类型	值
id_library_url	文本	6512406 （来自步骤 1）
id_library_file	文本	6884966 （来自步骤 2）
active	文本	1

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