📋

API概述

企业级多平台广告管理系统 RESTful API

150+
API端点
3
广告平台
24/7
API可用性

核心功能

  • 多平台广告账户统一管理
  • 智能广告投放与优化
  • 实时数据分析与报告
  • AI驱动的创意生成
  • Webhook事件通知
  • MCP协议集成
🔐

身份认证

API访问安全认证机制

Bearer Token认证

所有API请求都需要在请求头中包含有效的JWT令牌:

Authorization: Bearer <your-jwt-token>

获取令牌

POST /api/auth/login

用户登录并获取JWT令牌

{
  "email": "[email protected]",
  "password": "your-password"
}
⚠️ 安全提醒

请妥善保管您的JWT令牌,不要在客户端代码中硬编码令牌信息。

👤

账户管理

广告账户连接与管理功能

GET /api/accounts

获取用户关联的所有广告账户

查看响应示例
{
  "success": true,
  "data": [
    {
      "id": "acc_123456",
      "platform": "meta",
      "name": "示例Meta账户",
      "status": "active",
      "currency": "CNY",
      "timezone": "Asia/Shanghai",
      "connected_at": "2024-01-15T10:30:00Z"
    }
  ]
}
POST /api/accounts/connect

连接新的广告账户到系统

GET /api/accounts/{id}

获取特定账户的详细信息

📢

广告投放

广告系列创建、管理与优化

🎯 智能投放

  • • AI驱动的受众定向
  • • 自动预算优化
  • • 实时竞价调整
  • • 多平台同步投放

📊 性能监控

  • • 实时性能指标
  • • 自动异常检测
  • • 预警通知系统
  • • 优化建议推送
POST /api/ads/campaigns

创建新的广告系列

查看请求示例
{
  "name": "春季促销活动",
  "objective": "CONVERSIONS",
  "platform": "meta",
  "account_id": "acc_123456",
  "budget": {
    "budget_type": "DAILY",
    "amount": 1000,
    "currency": "CNY"
  },
  "targeting": {
    "age_min": 25,
    "age_max": 45,
    "locations": ["CN"],
    "interests": ["电商", "购物"]
  }
}
GET /api/ads/campaigns

获取广告系列列表,支持筛选和分页

PUT /api/ads/campaigns/{id}

更新广告系列设置,包括预算、定向等

📊

数据分析

深度数据洞察与智能分析

GET /api/analysis/performance

获取跨平台性能分析报告

支持指标: 展示量、点击量、转化率、CPC、ROAS、质量得分等
GET /api/analysis/realtime

实时广告性能监控数据

GET /api/analysis/recommendations

AI生成的优化建议和改进方案

🤖

AI智能服务

人工智能驱动的广告优化与决策

GET /api/ai/rules

管理AI自动化规则

预算管理
自动预算调整规则
出价优化
智能出价策略
GET /api/ai/decisions

查看AI自动决策历史记录

GET /api/ai/model-status

获取AI模型训练状态和性能指标

🎨

创意内容生成

AI驱动的广告创意自动化生成

POST /api/gemini-image/generate-script

生成图片创意关键帧脚本

POST /api/creative/generate-landing

智能生成产品落地页

POST /api/creative/image-prompts

生成高质量图片创意提示词

🔗

Webhook事件通知

实时事件推送与回调管理

支持的事件类型

• campaign_status_changed
• budget_alert
• performance_alert
• decision_executed
• ad_approved
• ad_rejected
POST /api/webhooks/endpoints

创建新的Webhook端点

GET /api/webhooks/events

查询Webhook事件发送历史

POST /api/webhooks/endpoints/{id}/test

测试Webhook端点可达性

MCP服务管理

Model Context Protocol 服务集成

GET /api/mcp/services

获取所有MCP服务状态

GET /api/mcp/monitoring

MCP服务性能监控数据

POST /api/mcp/services/{id}/restart

重启指定MCP服务

💻

SDK使用示例

各种编程语言的集成示例

JavaScript

const adsAPI = {
  baseURL: 'https://api.yourserver.com',
  token: 'your-jwt-token',

  async request(endpoint, options = {}) {
    const response = await fetch(`${this.baseURL}${endpoint}`, {
      ...options,
      headers: {
        'Authorization': `Bearer ${this.token}`,
        'Content-Type': 'application/json',
        ...options.headers
      }
    });
    return response.json();
  },

  // 获取广告账户
  getAccounts() {
    return this.request('/api/accounts');
  },

  // 创建广告系列
  createCampaign(data) {
    return this.request('/api/ads/campaigns', {
      method: 'POST',
      body: JSON.stringify(data)
    });
  }
};

// 使用示例
adsAPI.getAccounts().then(accounts => {
  console.log('广告账户:', accounts);
});

🐍 Python

import requests
from typing import Dict, Any

class AdsAPI:
    def __init__(self, base_url: str, token: str):
        self.base_url = base_url
        self.headers = {
            'Authorization': f'Bearer {token}',
            'Content-Type': 'application/json'
        }
    
    def get_accounts(self) -> Dict[str, Any]:
        """获取广告账户列表"""
        response = requests.get(
            f'{self.base_url}/api/accounts',
            headers=self.headers
        )
        return response.json()
    
    def create_campaign(self, data: Dict[str, Any]) -> Dict[str, Any]:
        """创建广告系列"""
        response = requests.post(
            f'{self.base_url}/api/ads/campaigns',
            json=data,
            headers=self.headers
        )
        return response.json()

# 使用示例
api = AdsAPI('https://api.yourserver.com', 'your-jwt-token')
accounts = api.get_accounts()
print('广告账户:', accounts)

快速开始步骤

  1. 注册账户并获取API密钥
  2. 通过 /api/auth/login 获取JWT令牌
  3. 在所有请求头中包含认证信息
  4. 参考Swagger文档了解详细API参数
  5. 设置Webhook接收事件通知