开发者文档

每个请求都通过在 Authorization 头中使用 Bearer 方案和密钥进行身份验证。

POST https://api.adhub365.com/v1/partner/ads
Authorization: Bearer sk_sandbox_...
Content-Type: application/json

如果您的 API 密钥为您的用户创建了广告主账户（连接模式——参见上文“身份验证”部分），您将获得这些广告主为广告支付费用的部分分成。下方的分成比例是实时从该端点读取的，绝非硬编码，且与本页面下方所述的推荐佣金完全无关。

GET https://api.adhub365.com/v1/partner-program

{
  "partner_share_percentage": 0.7,
  "platform_share_percentage": 0.3
}

工作原理

1. 您的某位“Connect”模式广告主通过您的集成渠道支付了广告费用。
2. 该广告已通过审核并获批准——无论是自动审核，还是由我们的审核团队审核。
3. 您的分红已加入队列，即将自动发放至您的钱包，其机制与下方的推荐计划相同。

赔付条件

• 您的合作伙伴账户上已配置了一个加密货币支付钱包。
• 您无需进行KYC认证——您的合作伙伴账户在创建时已经过审核。

示例：读取累计股数

GET https://api.adhub365.com/v1/partner/ad-revenue/earnings
Authorization: Bearer sk_sandbox_...

{
  "shares": [
    {
      "id": "share_1a2b...",
      "payment_id": "pay_9f2a...",
      "ad_id": "ad_7c31...",
      "partner_amount_usd": 140.0,
      "platform_amount_usd": 60.0,
      "status": "paid",
      "payable_after": "2026-08-03T00:00:00Z",
      "paid_at": "2026-08-05T10:12:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 140.0
}

每个广告主账户都配备了一套内置的AI工具——包括广告内容和视觉生成器、对话助手、预算顾问以及外部SEO审计工具——这些工具的费用需使用AI积分支付，此外还需支付固定的年度费用。

示例 — 生成广告内容

下方的图片生成器同样基于相同的类别和业务描述。

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "title": "Handmade Oak Dining Tables — Built to Last",
  "description": "Solid oak dining tables crafted by hand, built to last a lifetime.",
  "keywords": ["oak furniture", "dining table", "handmade"],
  "credits_remaining": 8
}

为同一则广告生成相应的视觉素材：

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio/image
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "visual_url": "https://cdn.uploadscenter.com/file_01m1...",
  "credits_remaining": 4
}

将现成的广告单元拖放到您自己的网站上——无需构建步骤，无需 iframe。该脚本会在隔离的 Shadow DOM 中直接渲染到页面中，因此其样式绝不会渗入您的网站，而您网站的样式也不会渗入其中。

将其添加到您的页面中

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>
<script async src="https://adhub365.com/widget.js"></script>

默认情况下，此处显示的是该类别的完整公开排名——即平台上的所有广告主，而不仅仅是您引入的那些。若要仅显示您通过“Connect”模式创建的广告主（即为您带来分成的那部分）的广告，请添加 data-partner 并填写您的合作伙伴 ID（可在您自己仪表盘的“开发者”页面中找到）：

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

如果您的广告商涉及多个类别，请完全移除 data-category —— 仅保留 data-partner 后，该小部件会将您所有类别的广告统一显示在一个网格中，而无需为每个类别单独设置一个小部件块：

<div
  class="annualads-widget"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

想在内容中的广告单元旁边再添加一个页脚风格的广告单元，并且每个单元显示不同的广告吗？请添加第二个小部件块，并设置 data-layout="compact"（单个广告，可折叠为小型圆点），同时将 data-offset 设置为第一个小部件当前已显示的广告数量：

<!-- in your content -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>

<!-- in your footer, showing different ads via data-offset -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-layout="compact"
  data-offset="4"
></div>
<script async src="https://adhub365.com/widget.js"></script>

属性

合作伙伴的推荐佣金究竟是如何到手的——具体比例、支付机制以及先决条件。

GET https://api.adhub365.com/v1/referral-program

{
  "levels": [
    {
      "level": 1,
      "percentage": 0.1
    }
  ],
  "leaders_pool_percentage_of_gmv": 0.05,
  "founding_advertiser_pool_percentage_of_gmv": 0.05,
  "payout_verification_window_hours": 48,
  "min_payout_usd": 1
}

赔付条件

• 广告主的应付总收益已达到最低支付金额。
• 他们的账户上已配置了一个加密货币提现钱包。
• 他们的KYC状态已通过验证。

示例：读取累计收益

GET https://api.adhub365.com/v1/partner/referrals/{code}/earnings
Authorization: Bearer sk_sandbox_...

{
  "code": "ann-2f8c",
  "earnings": [
    {
      "id": "earn_1a2b...",
      "payment_id": "pay_9f2a...",
      "amount_usd": 30.0,
      "status": "paid",
      "payable_after": "2026-08-01T00:00:00Z",
      "paid_at": "2026-08-03T14:22:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 30.0
}

定价档位（已上线）

请从该接口实时读取数据——切勿将这些值硬编码，因为这些值可能会由我们进行调整。 请为您的用户构建一个档位选择器，而非设置“免费金额”字段：显示的每个价格在创建支付时即为需发送的确切金额，且此处显示的解锁权益能让用户清楚了解该价格能获得什么，这样他们就能选择自己理解的价格，而不是凭空猜测一个数字。

每个密钥每分钟的请求次数设有上限。每个经过身份验证的响应都会携带 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 头部；若超过限制，将返回 429 Too Many Requests 状态码，并附带 Retry-After 头部。

可选，按合作伙伴设置。在添加条目之前，您的密钥会接受来自任何 IP 的请求——第一个条目会将该合作伙伴的所有密钥切换为仅允许来自白名单的请求。

每个 webhook 都会使用在创建时一次性生成的密钥通过 HMAC-SHA256 进行签名——在信任有效载荷之前，请先验证签名。事件仅会发送给拥有相关广告主的合作伙伴。