API 接口文档 - 优盟广告平台

📱 应用管理

GET/app/list

获取所有应用列表

参数	类型	必填	说明

返回示例:

[{"id":1,"appName":"测试应用","appId":"547273","packageName":"com.test.app","platform":"android","status":1}]

POST/app/create

创建新应用（AppId 自动生成 6 位数字）

参数	类型	必填	说明
appName*	String	是	应用名称
packageName*	String	是	包名
platform	String	否	平台：android/ios，默认 android

请求示例:

{"appName":"我的游戏","packageName":"com.mygame.app","platform":"android"}

DELETE/app/delete/{id}

删除应用

🎯 广告位管理

GET/pos/list?appId={id}

获取指定应用的广告位列表

参数	类型	必填	说明
appId*	Long	是	应用 ID

POST/pos/create

创建广告位（PosId 自动生成 9 位数字）

参数	类型	必填	说明
posName*	String	是	广告位名称
appId*	Long	是	应用 ID
adType*	String	是	类型：splash/reward/interstitial/banner/feed/fullscreen

DELETE/pos/delete/{id}

删除广告位

🔌 广告平台管理

GET/platform/list

获取所有广告平台列表

POST/platform/create

创建广告平台

参数	类型	必填	说明
platformCode*	String	是	平台代码：csj/gdt/baidu 等
platformName*	String	是	平台名称
appId	String	否	平台 App ID
appKey	String	否	平台 App Key

PUT/platform/update/{id}

更新广告平台

DELETE/platform/delete/{id}

删除广告平台

🔗 广告源管理

GET/source/list?posId={id}

获取指定广告位的广告源列表（按优先级排序）

参数	类型	必填	说明
posId*	Long	是	广告位 ID

POST/source/create

添加广告源

参数	类型	必填	说明
posId*	Long	是	广告位 ID
platformId*	Long	是	平台 ID
unitId	String	否	平台方广告位 ID
priority	Integer	否	优先级，数字越小优先级越高，默认 1
bidFloor	Double	否	底价，默认 0

DELETE/source/delete/{id}

删除广告源

📈 数据统计

GET/stats/overview

获取统计概览数据

返回示例:

{"impressions":1500,"clicks":80,"revenue":43.5,"ctr":"5.33","ecpm":"29.00"}

📝 说明

1. 认证方式：当前版本无需认证，后续版本将支持 API Key 认证

2. 返回格式：所有接口返回 JSON 格式数据

3. 错误码：

200 - 成功
400 - 请求参数错误
404 - 资源不存在
500 - 服务器内部错误

4. ID 生成规则：