帮助文章API 参考
Adgora REST API 可让您通过程序读取统计信息、列出和暂停广告活动、查询余额以及列出广告位。基础 URL： https://api.adgora.net. 所有响应均为 JSON。
身份验证
请在以下位置创建一对密钥： 您的个人资料 （密钥只显示一次）。请在每个 /v1 请求中发送它：
http
Authorization: Bearer {public_key}:{secret}请求速率限制为 每个账户每分钟 120 次；超出限制时返回 429 以及 Retry-After 响应头。密钥具有以下权限范围（stats, campaigns, balance, zones）；缺少所需权限范围时返回 403.
端点
| 方法 & 路径 | 权限范围 | 返回内容 |
|---|---|---|
GET /v1/balance | balance | 广告主 & 发布商的美元余额 |
GET /v1/stats?days=7 | stats | 每日记录（添加 role=publisher 即可查看发布商视图） |
GET /v1/campaigns | campaigns | 您的广告活动 |
POST /v1/campaigns/{id}/pause | campaigns | 暂停广告活动 |
POST /v1/campaigns/{id}/resume | campaigns | 恢复广告活动 |
GET /v1/zones | zones | 您的发布商广告位 |
示例
curl
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
"https://api.adgora.net/v1/stats?days=30"S2S 转化回传
如需跟踪 CPA 转化，请在转化发生时从广告主服务器调用回传 URL。以下 {clickid} 宏会通过点击 URL 传递到您的落地页 — 请记录它并回传：
url
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123status 的值可以是 confirmed, delivered, rejected 或 returned; order_ref 是可选的订单编号。请在对应的推广项目页面查找其专用密钥。
落地页 URL 宏
将这些宏添加到广告素材的落地页 URL 中 — Adgora 会在点击时替换它们：
{ }
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}构建请求
选择一个端点和参数 — 命令会随着您的操作而更新。密钥保持占位符：切勿将秘密粘贴到网页中。
角色
GET
https://api.adgora.net/v1/balancecurl
curl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"PUBLICKEY:SECRET 是一个占位符。在你的个人资料中创建一个密钥，并将秘密保存在你的服务器上。
