Wiñarichiqpa qillqankuna

Sapa mañakuyqa chiqanchasqa kachkan pakasqa kichwanawan Authorization umallinapi, Bearer esquemota llamk'achispa.

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

Sichus API kichanakiykikuna kikiykiq llamk'achiqniykikunapaq willakuqkunap qillqankunata kicharin (Connect rikch'aypi — qhawariy hawa kaqpi 'Cheqaqchay' nisqata), chay willakuqkuna willakuyninkumanta pagasqankumanta huk rakinata chaskinki. Kay urapi kaq rakiyqa kay kikin endpoint nisqamanta kikin pachapi ñawirisqa, manan hayk'aqpas sinchita qillqasqachu, hinaspapas kay p'anqap urayninpi kaq kachamusqa kamachiymanta hunt'asqata t'aqasqa kashan.

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

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

Imaynata llamk'an

1. Connect-mode nisqapi huk willayniyuqniyki, qampa t'inkinakuyniykiwan huk willaymanta pagapun.
2. Willakuyqa qhawarisqa hinaspa chaskisqa kachkan — kikinmanta, utaq qhawaq huñuykuwan.
3. Qampa rak'iykiqa q'ipichasqaña kachkan kikinmanta qullqi churanaykiman paganapaq, kay urapi kaq runa kachay programa hina.

Qullqi kutichiy kamachikuykuna

• Qampa masiykiq cuentanpi huk cripto qullqi chaskina wayaqa wakichisqa kachkan.
• Qampaqqa manam KYC nisqa mañakunchu — yanapaqniyki qillqayqa kamarisqa kasqanmantapachaña qhawarisqaña kachkan.

Rikuna: huñusqa rak'ikunata ñawinchay

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
}

Sapa willakuqpa yupayninmi chaskikun huk huñu ukhunpi kaq AI llamk'anakunata — huk willakuypaq imaymanakunata rikch'akunatapas paqarichiqta, huk rimanakuypi yanapaqta, huk qullqi kamachiypaq yuyaychaqta, hinallataq huk hawa SEO qhawaqta — AI kreditu nisqakunawan pagasqa, sapa wata churasqa chaninmanta yapaspa.

Rikuna — willaypaq qillqata ruray

Kikin t'aqa, ruruchinamanta willakuypas urapi kaq rikch'a ruraqta kallpachanku.

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
}

Kikin willakuypaq rikch'ayninta ruway:

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
}

Kikinpa web p'anqaykiman huk wakichisqaña willay t'aqata churay — mana wakichinapaq, mana iframe nisqapas. Scriptqa p'anqaman kikinmantan rikhurichin huk sapanchasqa Shadow DOM ukupi, chaymi kikinpa rikch'ayninqa manan hayk'aqpas web p'anqaykiman yaykunqachu, nitaq web p'anqaykipa rikch'ayninkunapas chayman yaykunqachu.

P'anqaykiman yapay

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

Qallariyninmantaqa, kayqa rikuchin llapanpaq qhawaychayta chay t'aqapaq — llapan kay patapi willay-qhatuqkunata, manan qam apamusqaykikunallatachu. Connect ñanwan paqarichisqayki willay-qhatuqkunap willayninkunallata rikuchinapaq (qampa rak'iykita paqarichiqkunata), data-partner nisqata yapay yanapaqniyki ID nisqawan (chayta tariy kikiykiq dashboardniykiq Developers rap'inpi):

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

Sichus willaykuna qhatuqniykikuna achka t'aqakunapi kanku chayqa, data-category nisqata tukuyta qichuy — data-partner sapallanwanqa, widgetqa llapan t'aqakunapi willaykuna qhatuqniykikunata huk siq'i t'aqapi rikuchin, sapa t'aqapaq huk widget t'aqa kananmantaqa:

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

¿Munaychu qillqasqaykipi kaq unidadpa waqtanpi huk footer hina unidadta, sapa huknin hukniray willakuykunata rikuchinankupaq? Iskay kaq widget block nisqata yapay, kaykunawan: data-layout="compact" (huk willakuylla, huch'uy pillaman hina k'umuykuna), hinallataq data-offset nisqata ñawpaq kaq widgetniyki hayk'a willakuykunataña rikuchisqanman hina churaspa:

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

Kayninkuna

Imaynatas huk yanapaqpa apachimusqanmanta chaskina qullqi paykunaman chayan — hayk'a pachakmanta kasqan, qullqi quna ñan, hinallataq ñawpaqmanta hunt'ana kamachikuykuna.

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
}

Qullqi kutichiy kamachikuykuna

• Willakuqpa llapan qunan qullqinqa aswan pisi quna qullqiman chayan.
• Paypa cuentanpiqa huk kriptomoneda qullqi chaskina wayaqacha wakichisqa kachkan.
• Paykunap KYC kayninqa chiqanchasqañam.

Qhawana: huñusqa qullqita ñawinchay

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
}

Chaninkuna patakuna (kawsachkan)

Kay endpointmanta kikinmanta ñawinchay — ama hayk'aqpas kay chaninkunata qillqapi takyachiychu, ñuqaykuq ladoykupiqa hukmanyayta atinmanmi. Qampa rantiqkunaykipaq huk patakuna akllanata ruway, mana huk qhasilla chanin k'itipa rantinpi: sapa rikuchisqa chaninqa ñam chiqan kachana qullqi, pagota ruwaspa, hinaspam kaypi rikuchisqa kichasqa allinkunaqa rantiqkunaman chiqanta willan imakunatachus chay chaninwan chaskinqaku, chayrayku paykunaqa hamut'asqanku chanita akllanqaku, huk yupayta watunanmantaqa.

Mañakuykunaqa sapa kichanapaq, sapa minutupi saywachasqa kachkan. Sapa chiqanchasqa kutichiyqa X-RateLimit-Limit, X-RateLimit-Remaining, hinallataq X-RateLimit-Reset umachakunata apamun; saywata yallispaqa 429 Nisyu Mañakuykuna nisqata kutichin, Retry-After umachawan.

Akllanalla, sapa masipaq. Huk yaykuchiyta yapaykukunaykikama, llawiñikikunaqa mayqin IP nisqamantapas mañakuykunata chaskinku — ñawpaq yaykuchiyqa chay masip llapan llawiñinkunata saqillasqa listallapaqman tikran.

Sapa webhookqa HMAC-SHA256 nisqawan qillqasqa kachkan, kamarisqa pachapi huk kutillapaq qusqa pakasqa simita llamk'achispa — apachimusqan willayta manaraq iñishaspa, chay qillqasqata allinta qhawariy. Willaykunaqa chay willakuqpa kapuqnin masillamanmi apachikun.