📋
API概述
企业级多平台广告管理系统 RESTful API
150+
API端点
3
广告平台
24/7
API可用性
核心功能
- ✓ 多平台广告账户统一管理
- ✓ 智能广告投放与优化
- ✓ 实时数据分析与报告
- ✓ AI驱动的创意生成
- ✓ Webhook事件通知
- ✓ MCP协议集成
🔐
身份认证
API访问安全认证机制
Bearer Token认证
所有API请求都需要在请求头中包含有效的JWT令牌:
Authorization: Bearer <your-jwt-token>
获取令牌
⚠️
安全提醒
请妥善保管您的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)
快速开始步骤
- 注册账户并获取API密钥
- 通过
/api/auth/login获取JWT令牌 - 在所有请求头中包含认证信息
- 参考Swagger文档了解详细API参数
- 设置Webhook接收事件通知