Geliştirici belgeleri

Her istek, Bearer şeması kullanılarak Authorization başlığındaki gizli anahtarla doğrulanır.

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

API anahtarlarınız kendi kullanıcılarınız için reklamveren hesapları oluşturuyorsa (Bağlantı modu — yukarıdaki “Kimlik Doğrulama” bölümüne bakın), bu reklamverenlerin reklamları için ödedikleri tutarın bir kısmını kazanırsınız. Aşağıdaki pay dağılımı, bu aynı uç noktadan gerçek zamanlı olarak okunur; hiçbir zaman sabit kodlanmaz ve bu sayfanın ilerleyen kısımlarında belirtilen yönlendirme komisyonundan tamamen ayrıdır.

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

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

Nasıl çalışır?

1. Connect modundaki reklamverenlerinizden biri, entegrasyonunuz aracılığıyla bir reklam için ödeme yapıyor.
2. Reklam, otomatik olarak ya da denetim ekibimiz tarafından incelenir ve onaylanır.
3. Payınız, aşağıdaki tavsiye programındaki mekanizma ile aynı şekilde cüzdanınıza otomatik olarak ödenmek üzere sıraya alınmıştır.

Ödeme koşulları

• Ortaklık hesabınızda bir kripto ödeme cüzdanı yapılandırılmıştır.
• Sizin tarafınızdan herhangi bir KYC işlemi gerekmez — ortaklık hesabınız oluşturulurken zaten doğrulanmıştır.

Örnek: birikmiş hisselerin okunması

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
}

Her reklamveren hesabına, sabit yıllık ücretin yanı sıra, AI kredileriyle ödenen bir dizi yerleşik AI aracı sunulur: bir reklam içeriği ve görsel oluşturucu, bir sohbet asistanı, bir bütçe danışmanı ve bir harici SEO denetçisi.

Örnek — reklam içeriği oluşturma

Aşağıdaki resim oluşturucuya da aynı kategori ve işletme açıklaması temel alınarak oluşturulmuştur.

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
}

Aynı reklam için uygun bir görsel oluşturun:

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 bir reklam birimini kendi sitenize sürükleyip bırakın — kurulum gerektirmez, iframe kullanmaya gerek yoktur. Komut dosyası, izole edilmiş bir Shadow DOM içinde doğrudan sayfaya yüklenir; bu sayede, reklam biriminin stilleri asla sitenize sızmaz ve sitenizin stilleri de reklam birimine sızmaz.

Sayfanıza ekleyin

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

Varsayılan olarak bu, kategorinin tam genel sıralamasını gösterir — sadece sizin platforma kazandırdıklarınız değil, platformdaki tüm reklamverenler. Yalnızca Connect modu aracılığıyla oluşturduğunuz reklamverenlerin reklamlarını (payınızı oluşturan reklamları) göstermek için, ortak kimliğinizi içeren “data-partner” özniteliğini ekleyin (bu kimliği kendi kontrol panelinizin Geliştiriciler sayfasında bulabilirsiniz):

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

Reklamverenleriniz birkaç kategoriye yayılıyorsa, “data-category” özniteliğini tamamen kaldırın — sadece “data-partner” özniteliği kullanıldığında, widget tüm kategorilerdeki reklamlarınızın her birini tek bir ızgarada gösterir; böylece her kategori için ayrı bir widget bloğu kullanmanıza gerek kalmaz:

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

İçerik içi reklam bloğunuzun yanında, her biri farklı reklamlar gösteren bir altbilgi tarzı reklam bloğu mu istiyorsunuz? data-layout="compact" (tek bir reklam, küçük bir hap şeklinde daraltılabilir) ve data-offset değeri ilk widget’ınızın halihazırda gösterdiği reklam sayısına ayarlanmış ikinci bir widget bloğu ekleyin:

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

Özellikler

Bir iş ortağının tavsiye komisyonunun kendisine nasıl ulaştığı — yüzde oranı, ödeme mekanizması ve ön koşullar.

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
}

Ödeme koşulları

• Reklamverenin ödenecek toplam kazancı, minimum ödeme tutarına ulaşır.
• Hesaplarında bir kripto para ödeme cüzdanı yapılandırılmıştır.
• KYC durumları doğrulanmıştır.

Örnek: birikmiş kârın okunması

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
}

Fiyatlandırma kademeleri (canlı)

Bu uç noktadan canlı olarak okuyun — bu değerleri asla sabit olarak kodlamayın; bunlar bizim tarafımızdan değiştirilebilir. Ücretsiz tutar alanı yerine kendi kullanıcılarınız için bir seviye seçici oluşturun: gösterilen her fiyat, ödeme oluşturulurken gönderilecek tam tutardır ve burada gösterilen kilidi açılmış avantajlar, kullanıcılara bu fiyat karşılığında ne elde edeceklerini tam olarak belirtir; böylece kullanıcılar bir rakam tahmin etmek yerine anladıkları bir fiyatı seçerler.

İstekler, anahtar başına ve dakika başına bir sınırla kısıtlanmaktadır. Kimliği doğrulanmış her yanıtta X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıkları bulunur; sınırın aşılması durumunda, Retry-After başlığı içeren 429 Too Many Requests hatası döndürülür.

İsteğe bağlı, her bir iş ortağı için. Bir kayıt ekleyene kadar, anahtarlarınız herhangi bir IP adresinden gelen istekleri kabul eder — ilk kayıt, o iş ortağının tüm anahtarlarını yalnızca izin verilenler listesine göre çalışacak şekilde değiştirir.

Her webhook, oluşturulduğu anda tek seferlik olarak verilen bir gizli anahtar kullanılarak HMAC-SHA256 ile imzalanır — yük bilgisine güvenmeden önce imzayı doğrulayın. Olaylar, yalnızca ilgili reklamverenin sahibi olan iş ortağına iletilir.