> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/api/zh/exoclick-gong-gong-api/api-manual-postman-examples.md).

# Postman 示例

## 概述

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

## 身份验证（登录）

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

{% tabs %}
{% tab title="使用用户名和密码登录" %}
**请求类型：** `POST`\
**URL：** `https://api.exoclick.com/v2/login`

**请求头：**

```
Content-Type: application/json
```

**请求体（原始 JSON）：**

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

{% endtab %}

{% tab title="使用 API 令牌登录" %}
如果您已在 ExoClick 仪表板中生成令牌（个人资料 > API 令牌），请使用此方式。

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

**请求头：**

```
Content-Type: application/json
```

**请求体（原始 JSON）：**

```json
{
  "api_token": "YOUR_API_TOKEN"
}
```

{% endtab %}
{% endtabs %}

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

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

{% stepper %}
{% step %}

### 创建落地页 URL（库）

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

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

**请求头：**

```
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
```

**请求体（原始 JSON）：**

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

**结果：** 保存返回的 `"id"` （例如， `6512406`).
{% endstep %}

{% step %}

### 上传图片（库）

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

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

**请求头：**

```
Authorization: Bearer YOUR_TOKEN
```

**请求体（form-data）：**

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

**结果：** 保存返回的 `"id"` （例如， `6884966`).
{% endstep %}

{% step %}

### 创建广告系列框架

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

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

**请求头：**

```
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
```

**请求体（原始 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`).
{% endstep %}

{% step %}

### 添加变体

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

**请求类型：** `POST`\
**URL：** `https://api.exoclick.com/v2/campaigns/8140060/variation`\
\&#xNAN;*（替换 `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 替换为您实际的值。
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/api/zh/exoclick-gong-gong-api/api-manual-postman-examples.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.