Moheñóihára kuatiakuéra

Opaite jerure oñemboaje peteĩ llave ñemimby rupive pe cabecera Autorización-pe, oipurúvo pe esquema Bearer.

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

Ne API lláve-kuéra ojapóramo maranduhára kuenta ne puruhárakuérape g̃uarã (modo Connect — ehecha Autentikasiõ yvateve), reganáta peteĩ pehẽngue umi maranduhára ohepyme'ẽvagui imarandukuérare. Pe pehẽngue joja oĩva iguýpe oñemoñe'ẽ en vivo ko endpoint-gui voi, araka'eve ndojehaíri código-pe, ha ojeiite pe komisiõ referral-gui oĩva ko páhina iguýpeve.

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

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

Mba'éichapa omba'apo

1. Peteĩ ne anunciante Connect-mode-pegua ohepyme'ẽ peteĩ anuncio ne ñembojoajuha rupive.
2. Pe marandu oñehesa'ỹijo ha oñemoneĩ — ijeheguiete, térã ore aty oñangarekóva rupive.
3. Ne pehẽngue oĩma oñeha'ãrõvo oñeme'ẽ hag̃ua ijeheguiete ne virurúpe, upeichaite avei pe programa de referidos oĩva iguýpe.

Mba'éichapa oñeme'ẽta

• Oñemohenda peteĩ billetera de pago cripto nde kuenta sósiope.
• Ndoikotevẽi KYC ndehegui — ne sócio kuenta oñehesa'ỹijopáma ojejapo vove.

Techapyrã: moñe'ẽ umi vore oñembyatýva

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
}

Opaite maranduhára kuenta oguereko peteĩ aty tembiporu AI oñemoingéva ipype — peteĩ moheñóihara marandu ha ta'angápe guarã, peteĩ pytyvõhára ñomongetarã, peteĩ moñe'ẽngára viru jeporurãme guarã, ha peteĩ ohesa'ỹijóva SEO okápegua — oñehepyme'ẽva AI kredito-kuérape, pe hepykue peteĩcha ary pukukueguáre ári.

Techapyrã — moheñói marandu ñemurãrã

Upe aty ha ñemuha mombe'u avei omombarete pe ta'anga apoha oĩva iguýpe.

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
}

Emoheñói peteĩ ta'anga ojoguáva upe marandurãme g̃uarã:

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
}

Emoinge peteĩ marandu vore oĩmbámava nde ñanduti rendápe — ndereikotevẽi remopu'ã, ndereikotevẽi iframe. Pe script ohechauka hekópe pe kuatiápe peteĩ Shadow DOM oñemoha'eñóva ryepýpe, upéicha rupi isitilokuéra araka'eve ndohasái nde ñanduti rendápe, ha nde ñanduti renda sitilokuéra avei araka'eve ndohasái ipype.

Emoĩ nde kuatiápe

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

Iñepyrũmbyháicha, kóva ohechauka pe ñemohenda pavẽ opavavépe g̃uarã upe vorepegua — opaite maranduhára oĩva ko plataforma-pe, ndaha'éi umi nde reguerúva añónte. Rehechauka hag̃ua umi marandu maranduhára remopu'ãva'ekue Connect mode rupivegua añónte (umi ome'ẽva nde pehẽngue), emoĩ data-partner ne socio ID ndive (ejuhu upéva ne dashboard-pe, Developers kuatiápente):

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

Ne maranduhára oĩramo heta vore'ípe, eipe'apaite pe data-category — pe data-partner-nte reheve, pe widget ohechauka opaite ne maranduhakuéra opaite vore'i pegua peteĩ kuádro-pe, tekotevẽ'ỹre peteĩ widget vore'i peteĩteĩme g̃uarã:

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

Reipotápa peteĩ unidad footer-ichagua ne contenido peguápe ykére, mokõivéva ohechaukávo marandu iñambuéva? Emoĩve peteĩ widget aty mokõiha data-layout="compact" reheve (peteĩ marandu año, ikatu oñemboguejy peteĩ píldora michĩvape) ha data-offset emohenda he'iháicha mboy marandúpa ne widget peteĩha ohechaukáma:

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

Mba'etee

Mba'éichapa pe comisión oñeme'ẽva peteĩ oipytyvõvape og̃uahẽ añetehápe chupe — pe porcentáhe, mba'éichapa oñeme'ẽ, ha umi mba'e oñeikotevẽva tenonderã.

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
}

Mba'éichapa oñeme'ẽta

• Pe omoherakuãva pirapire oñembyatyva'erã og̃uahẽ pe oñeme'ẽva'erã michĩvévape.
• Oñemohenda peteĩ billetera de pago criptomoneda-pe g̃uarã i-cuéntape.
• Oñemboaje hekove rechaukaha.

Techapyrã: oñemoñe'ẽ pirapire oñembyatýva

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
}

Tape hepykue (oikóva)

Emoñe'ẽ ko endpoint-gui en vivo — ani araka'eve emoinge ko'ã valor código-pe, ikatu oñemoambue ore ykére. Ejapo peteĩ oiporavo hag̃ua hepykue ñemohenda ne puruhárakuérape g̃uarã, peteĩ tenda oñemoĩhápe hepykue rei rangue: opaite hepykue ojehechaukáva ha'éma pe viru teete oñemondova'erã ojejapo jave pe jepaga, ha umi mba'e porã ojehechaukáva ko'ápe he'i puruhárakuérape mba'épa ome'ẽ chupekuéra upe hepykue, upéicha oiporavo hikuái peteĩ hepykue oikũmbýva oha'ã rangue peteĩ papapy.

Oñembotapykue jerurekue peteĩteĩ llave-pe g̃uarã, peteĩ aravo'ípe. Opaite mbohovái oñemboaje va'ekue ogueraha umi akã X-RateLimit-Limit, X-RateLimit-Remaining, ha X-RateLimit-Reset; ohasáramo pe tembe'y, ombohovái 429 Jerurekue Hetaite ha ogueraha hendive peteĩ akã Retry-After.

Ndaikatúi, peteĩteĩ irũme g̃uarã. Remoinge mboyve peteĩ jehaipyre, ne llávekuéra oheja oñeporandu oimeraẽ IP-gui — pe jehaipyre peteĩha omboheko opaite upe irũ llávekuéra oheja hag̃ua oñeporandu oñemoneĩmbyréva rupivénte.

Webhook peteĩteĩ oñemboheraguapy HMAC-SHA256 rupive, ojeipurúvo peteĩ ñe'ẽñemi oñeme'ẽva peteĩ jevy, ojejapo vove — embojoja pe heraguapy rejerovia mboyve marandúre. Umi mba'e ojehúva oñemondo pe irũme añoite ha'éva pe maranduhára jára.