İnkişaf etdirici sənədləri

Hər bir tələb Authorization başlığındakı gizli açarla Bearer sxemi istifadə edilərək autentifikasiya olunur.

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

Əgər API açarlarınız öz istifadəçiləriniz üçün reklamçı hesabları yaradırsa (Connect rejimi — yuxarıdakı Təsdiqləmə bölməsinə baxın), o reklamçıların reklamlarına ödədikləri məbləğin bir hissəsini qazanırsınız. Aşağıdakı bölüşdürmə eyni endpoint-dən canlı oxunur, heç vaxt sərt kodlaşdırılmayıb və bu səhifənin daha aşağısındakı referal komissiyasından tamamilə ayrıdır.

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

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

Bu necə işləyir

1. Connect-rejimindəki reklam verənlərinizdən biri inteqrasiyanız vasitəsilə reklam üçün ödəniş edir.
2. Reklam nəzərdən keçirilir və təsdiqlənir — avtomatik olaraq və ya moderatorlar komandamız tərəfindən.
3. Payınız avtomatik olaraq cüzdanınıza ödəniş üçün növbəyə qoyulub, bu, aşağıdakı istinad proqramındakı mexanizmlə eynidir.

Ödəniş şərtləri

• Tərəfdaş hesabınızda kriptovalyuta ödəniş cüzdanı konfiqurasiya edilib.
• Sizin tərəfdən KYC tələb olunmur — tərəfdaş hesabınız yaradılarkən artıq yoxlanılıb.

Məsələn: yığılmış səhm paylarını oxumaq

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
}

Hər reklam verən hesabı ilkin illik ödənişdən əlavə olaraq AI kreditləri ilə ödənilən daxili AI alətlər dəstini əldə edir — reklam məzmunu və vizual generator, söhbət köməkçisi, büdcə məsləhətçisi və xarici SEO auditoru.

Məsələn — reklam məzmunu yaradın

Eyni kateqoriya və biznes təsviri aşağıdakı görüntü generatorunu da işə salır.

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
}

Eyni reklam üçün uyğun vizual yaradın:

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
}

Hazır reklam vahidini saytınıza yerləşdirin — heç bir qurma addımı, heç bir iframe yoxdur. Skript izolyasiya olunmuş Shadow DOM daxilində birbaşa səhifədə render olunur, buna görə onun stilləri heç vaxt saytınıza keçmir, saytınızın stilləri isə ora keçmir.

Onu səhifənizə əlavə edin

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

Standart olaraq bu, kateqoriya üçün tam ictimai reytinqi göstərir — yalnız sizin gətirdiyiniz reklamçılar deyil, platformadakı bütün reklamçıları. Connect rejimi vasitəsilə yaratdığınız (sizin payınızı formalaşdıran) reklamçıların reklamlarını yalnız göstərmək üçün data-partner atributunu tərəfdaş ID-nizlə əlavə edin (onu öz idarə panelinizin Tərtibatçılar səhifəsində tapa bilərsiniz):

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

Əgər reklam verənləriniz bir neçə kateqoriyaya aiddirsə, data-category atributunu tamamilə buraxın — yalnız data-partner ilə vidjet bütün kateqoriyalar üzrə reklamlarınızın hər birini tək bir şəbəkədə göstərir, hər kateqoriya üçün ayrıca vidjet bloku tələb etmədən:

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

Məzmun içindəki vahidlə yanaşı, fərqli reklamlar göstərən başlıq tərzi bir vahid istəyirsiniz? data-layout="compact" (tək reklam, kiçik pillə şəklində qatlanabilən) və data-offset dəyərini ilk widgetinizin artıq göstərdiyi reklam sayına görə təyin edən ikinci widget bloku əlavə edin:

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

Xüsusiyyətlər

Tərəfdaşın yönləndirmə komissiyasının onlara necə çatdığı — faiz dərəcəsi, ödəniş mexanizmi və əvvəlcədən şərtlər.

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
}

Ödəniş şərtləri

• Reklam verənin ödənilməli ümumi gəlirləri minimum ödəmə məbləğinə çatır.
• Onların hesabında kriptovalyuta ödəniş cüzdanı konfiqurasiya edilib.
• Onların KYC statusu təsdiqlənib.

Məsələn: yığılan gəlirləri oxumaq

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
}

Qiymət səviyyələri (canlı)

Bu endpoint-dan canlı oxuyun — bu dəyərləri heç vaxt kodda birbaşa yazmayın, onlar bizim tərəfdə dəyişə bilər. Pulsuz məbləğ sahəsi əvəzinə öz istifadəçiləriniz üçün səviyyə seçicisi yaradın: göstərilən hər bir qiymət ödəniş yaradılarkən göndərilməli dəqiq məbləğdir və burada göstərilən açılmış üstünlüklər istifadəçilərə həmin qiymətin onlara nə qazandırdığını dəqiq izah edir, beləliklə onlar rəqəm təxmin etmək əvəzinə başa düşdükləri qiyməti seçirlər.

Hər açar üçün dəqiqə başına sorğular məhdudlaşdırılır. Hər autentifikasiya olunmuş cavab X-RateLimit-Limit, X-RateLimit-Remaining və X-RateLimit-Reset başlıqlarını daşıyır; limitdən artıq sorğu isə Retry-After başlığı ilə 429 Too Many Requests səhvini qaytarır.

Hər tərəfdaş üçün seçməli. Giriş əlavə edənə qədər açarlarınıza istənilən IP-dən sorğu qəbul edilir — ilk giriş həmin tərəfdaşın bütün açarlarını yalnız icazə verilən siyahıya keçirir.

Hər bir webhook, yaradılma zamanı bir dəfə verilən gizli açar istifadə edilərək HMAC-SHA256 ilə imzalanır — yükü etibar etməzdən əvvəl imzoyu təsdiqləyin. Hadisələr yalnız müvafiq reklam verəni sahibi olan tərəfdaşa çatdırılır.