Documentación do desenvolvedor

Cada solicitude autentícase cunha clave secreta na cabeceira Autorización, empregando o esquema Bearer.

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

Se as túas claves de API crean contas de anunciantes para os teus propios usuarios (modo Connect — véxase Autenticación máis arriba), gañas unha parte do que eses anunciantes pagan polos seus anuncios. A repartición que aparece a continuación léese en tempo real desde este mesmo punto final, nunca está codificada en pedra e é completamente independente da comisión de referencia máis abaixo nesta páxina.

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

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

Como funciona

1. Un dos teus anunciantes en modo Connect paga un anuncio a través da túa integración.
2. O anuncio revísase e apróbase — automaticamente ou polo noso equipo de moderación.
3. A túa parte está na cola para o pago automático á túa carteira, o mesmo mecanismo que no programa de referencias de abaixo.

Condicións de pago

• Unha carteira de pago en criptomoedas está configurada na túa conta de socio.
• Non se require KYC por parte túa — a túa conta de socio xa foi verificada no momento da súa creación.

Exemplo: lectura de accións acumuladas

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
}

Cada conta de anunciante recibe un conxunto de ferramentas de IA integradas — un xerador de contido e imaxes publicitarias, un asistente conversacional, un asesor de orzamento e un auditor SEO externo — pagadas con créditos de IA, ademais do prezo anual fixo.

Exemplo — xerar contido de anuncio

A mesma categoría e descrición do negocio tamén alimentan o xerador de imaxes a continuación.

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
}

Xera unha imaxe visual correspondente para o mesmo anuncio:

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
}

Solta unha unidade de anuncio prefabricada no teu propio sitio — sen necesidade de construír nada, sen iframe. O script renderízase directamente na páxina dentro dun Shadow DOM illado, de xeito que os seus estilos nunca se filtran no teu sitio e os estilos do teu sitio nunca se filtran nel.

Engádeo á túa páxina

<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>

Por defecto, isto amosa a clasificación pública completa da categoría — todos os anunciantes da plataforma, non só os que ti achegaches. Para amosar só os anuncios dos anunciantes que creaches a través do modo Connect (os que xeran a túa cota), engade data-partner co teu ID de socio (podes atopalo na páxina de Desenvolvedores do teu propio panel de control):

<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>

Se os teus anunciantes abarcan varias categorías, elimina por completo data-category — só con data-partner, o widget amosa todos os teus anuncios en todas as categorías nunha única cuadrícula, en lugar de necesitar un bloque de widget por categoría:

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

¿Queres unha unidade de estilo de pé de páxina xunto á túa de contido, cada unha amosando anuncios diferentes? Engade un segundo bloque de widgets con data-layout="compact" (un único anuncio, colapsable nunha pequena píldora) e data-offset configurado ao número de anuncios que xa amosa o teu primeiro widget:

<!-- 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>

Atributos

Como a comisión de referencia dun socio realmente chega a el — o porcentaxe, o mecanismo de pago e as precondicións.

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
}

Condicións de pago

• Os ingresos totais pagables do anunciante alcanzan a cantidade mínima de pago.
• Unha carteira de pago en criptomoedas está configurada na súa conta.
• O seu estado KYC está verificado.

Exemplo: lectura dos beneficios acumulados

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
}

Niveis de prezos (en directo)

Ler en directo desde este punto final — non codifiques estes valores en pedra, poden cambiar do noso lado. Crea un selector de niveis para os teus propios usuarios en lugar dun campo de contía libre: cada prezo que se mostra é xa a contía exacta que hai que enviar ao crear o pago, e os beneficios desbloqueados que se amosan aquí din aos usuarios exactamente o que lles ofrece ese prezo, para que elixan un prezo que comprendan en lugar de adiviñar un número.

As solicitudes están limitadas por chave e por minuto. Cada resposta autenticada inclúe as cabeceiras X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset; superar o límite devolve un código 429 Too Many Requests cunha cabeceira Retry-After.

Opcional, por socio. Ata que engadas unha entrada, as túas claves aceptan solicitudes de calquera IP — a primeira entrada cambia todas as claves dese socio para que só permitan solicitudes da lista de permitidos.

Cada webhook está asinado con HMAC-SHA256 empregando un segredo emitido unha soa vez no momento da creación — comproba a sinatura antes de confiar na carga útil. Os eventos entreganse só ao socio que posúe o anunciante correspondente.