流量主 API

流量主端接口前缀为 /api/publisher。除登录 / 注册 / 找回密码外，均需携带流量主 JWT：Authorization: Bearer <token>。

响应结构、分页与错误码约定见 概述与鉴权。

认证

登录

POST /api/publisher/auth/login

参数	类型	必填	说明
username	string	是	用户名或注册邮箱
password	string	是	登录密码

curl -X POST https://api.adbnk.co/api/publisher/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"pub_demo","password":"secret123"}'

响应结构同广告主登录，返回 token / token_type / expires_in / user。

其他认证接口

方法	路径	说明
POST	/auth/register	注册
POST	/auth/forgot-password	发送重置邮件，参数 email
POST	/auth/reset-password	参数 token、new_password、confirm_password
POST	/auth/logout	登出
GET	/auth/profile	当前登录流量主信息
POST	/auth/password	修改密码（old_password/new_password/confirm_password）

站点（Site）

列表

GET /api/publisher/sites

参数	类型	必填	说明
page / page_size	int	否	分页
keyword	string	否	名称/域名搜索
status	string	否	状态
audit_status	string	否	审核状态
start_date / end_date	date	否	创建时间范围

创建站点

POST /api/publisher/sites

参数	类型	必填	说明
name	string	是	站点名称
media_type	string	否	媒体类型：WEB（默认）/APP/MINI_PROGRAM
domain	string	是*	WEB 类型必填，需为合法域名且未被占用
app_package	string	是*	APP/小程序必填，包名唯一
url	string	否	站点 URL，WEB 未填时自动用 https://<domain>
description	string	否	站点描述
industry_id	int	否	行业 ID
icp	string	否	ICP 备案号

curl -X POST https://api.adbnk.co/api/publisher/sites \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name":"我的博客","media_type":"WEB","domain":"blog.example.com"}'

新建站点默认 audit_status=PENDING，需审核通过后方可创建广告位。

站点其他操作

方法	路径	说明
GET	/sites/{id}	详情
PUT	/sites/{id}	更新
DELETE	/sites/{id}	删除
POST	/sites/{id}/toggle	启停
GET	/sites/{id}/stats	站点统计
GET	/sites/{id}/verify-code	获取归属验证代码
POST	/sites/{id}/verify	验证站点归属，参数 method

广告位（Zone）

列表

GET /api/publisher/zones

参数	类型	必填	说明
site_id	int	否	按站点筛选
type	string	否	广告类型筛选
status	string	否	状态
audit_status	string	否	审核状态
keyword	string	否	名称搜索

创建广告位

POST /api/publisher/zones

参数	类型	必填	说明
name	string	是	广告位名称
site_id	int	是	所属站点，须属于当前流量主且已审核通过
ad_type / type	string	是	广告类型，如 BANNER（默认）/NATIVE/VIDEO/POPUP/REWARDED 等
ad_format_id	int	否	广告格式 ID
zone_type_id	int	否	广告位类型 ID
size_id	int	否	尺寸 ID
width	int	否	宽度，默认 300
height	int	否	高度，默认 250
position	string	否	位置，默认 CONTENT
device	string	否	设备，默认 ALL
pricing_types	string	否	计费类型，默认 CPC,CPM
floor_price_cpc	number	否	CPC 底价，默认 0
floor_price_cpm	number	否	CPM 底价，默认 0

创建成功后系统自动生成唯一 zone_key（形如 zone_ab12cd34），用于广告请求。

广告位其他操作

方法	路径	说明
GET	/zones/{id}	详情
PUT	/zones/{id}	更新（site_id 不可改）
DELETE	/zones/{id}	删除
POST	/zones/{id}/toggle	启停
GET	/zones/{id}/code	获取投放代码
GET	/zones/{id}/preview	预览
POST	/zones/{id}/submit-audit	提交审核
GET	/zones/{id}/stats	广告位统计

获取到 zone_key 后即可发起广告请求，详见 广告请求 API。

收益报表

方法	路径	说明
GET	/statistics/report	汇总报表
GET	/statistics/sites	按站点维度
GET	/statistics/zones	按广告位维度
GET	/statistics/region	地域（geo）报表
GET	/statistics/hourly	分时报表
GET	/statistics/device	设备报表
GET	/statistics/export	导出

GET /api/publisher/statistics/report 参数：

参数	类型	必填	说明
start_date	date	否	起始日期，默认 7 天前
end_date	date	否	结束日期，默认今天
group_by	string	否	分组维度，默认 date
site_id	int	否	指定站点

提现

方法	路径	说明
GET	/withdrawals/balance	查询可提现余额
GET	/withdrawals	提现记录列表
POST	/withdrawals	发起提现
GET	/withdrawals/transactions	资金流水
GET	/withdrawals/payment-methods	可用提现渠道
GET	/withdrawals/bank-cards	银行卡列表
POST	/withdrawals/bank-cards	新增银行卡
DELETE	/withdrawals/bank-cards/{id}	删除银行卡
GET	/withdrawals/{id}	提现详情
POST	/withdrawals/{id}/cancel	取消提现

发起提现

POST /api/publisher/withdrawals

参数	类型	必填	说明
amount	number	是	提现金额，须大于 0 且不低于渠道最小额
payment_method / channel	string	是	提现渠道：BANK/USDT/PAYPAL/PAXUM
account_info	string	否	收款账户信息（渠道相关）
bank_info	object	否	银行渠道的账户明细

KYC 硬门禁

提现要求账户完成 KYC 实名认证（kyc_status = approved）且资料完善度达到 verified，否则返回 412，响应 data 中包含 requires_kyc、kyc_status、kyc_url 等提示字段。

curl -X POST https://api.adbnk.co/api/publisher/withdrawals \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"amount": 300, "payment_method": "USDT", "account_info": "TRC20:TXxxxx"}'

手续费与税费按平台及渠道配置计算，最终到账金额 = 提现金额 − 手续费 − 税费。结算与提现规则详见 结算与提现指南。

TIP

更多流量主功能（黑名单、通知绑定、返佣等）请以流量主控制台为准。