v1.0.0

AffiliateHub API Dokümantasyonu

AffiliateHub, e-ticaret sitenize influencer affiliate takibini entegre etmenizi sağlar. İki yöntemle entegrasyon yapabilirsiniz:

📄 tracker.js

Sitenize JS kodu ekleyin. Cookie takibi ve satış bildirimi otomatik çalışır.

✓ Önerilen yöntem

🔗 Webhook

Sipariş tamamlandığında sunucudan sunucuya POST isteği gönderin.

✓ Sunucu taraflı

🔑 Kimlik Doğrulama

Tüm istekler api_key parametresi gerektirir.

API anahtarınızı nereden alırsınız?

Firma Paneli → JS Snippet sayfasında API anahtarınızı bulabilirsiniz.

Örnek

{
  "api_key": "DHo9tAHcdAtRi3ESR0VRpO1lVcU3oZg3",
  "order_id": "12345",
  "amount": 299.90
}

📄 Tracker.js Kurulum

Sitenizin tüm sayfalarına </body> etiketinden önce ekleyin:

<script src="https://affiliation.refhub.com.tr/tracker.js?key=API_ANAHTARINIZ"></script>

ℹ️ Otomatik çalışır

Script yüklendiğinde URL'deki ?ref=slug parametresini otomatik algılar ve 30 günlük cookie kaydeder.

💰 Satış Bildirimi (tracker.js)

Sipariş tamamlama sayfasına şu kodu ekleyin:

<!-- Önce sipariş bilgilerini tanımlayın -->
<script>
window.AFF_ORDER = {
    id:           "SIPARIS_NO",   // Sipariş numarası
    amount:       TUTAR,           // Tutar (sayı)
    product_id:   "URUN_ID",       // Ürün ID (opsiyonel)
    product_name: "URUN_ADI"       // Ürün adı (opsiyonel)
};
</script>

<!-- Sonra tracker.js'i yükleyin -->
<script src="https://affiliation.refhub.com.tr/tracker.js?key=API_ANAHTARINIZ"></script>

🔗 Webhook — Özel Yazılım

Sipariş tamamlandığında şu URL'ye POST isteği gönderin:

POST https://affiliation.refhub.com.tr/api/webhook/custom/{api_key}

Request Body:

{
  "order_id":    "12345",        // Zorunlu - Benzersiz sipariş ID
  "amount":      299.90,         // Zorunlu - Sipariş tutarı
  "ref":         "ref-abc123",   // Zorunlu - Referral slug
  "product_id":  "42",           // Opsiyonel
  "product_name":"Ürün Adı"      // Opsiyonel
}

PHP Örneği:

$payload = [
    'order_id' => $order->id,
    'amount'   => $order->total,
    'ref'      => $_COOKIE['aff_ref'] ?? null,
];

$ch = curl_init('https://affiliation.refhub.com.tr/api/webhook/custom/API_ANAHTARINIZ');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

Başarılı Response:

{"success": true}

🔗 Ticimax Entegrasyonu

1
Ticimax admin panelinde Ayarlar → Entegrasyonlar → Webhook bölümüne gidin.
2
Sipariş tamamlama webhook URL'sine şunu ekleyin:

https://affiliation.refhub.com.tr/api/webhook/ticimax/API_ANAHTARINIZ

Ticimax'ın gönderdiği parametreler:

orderId — Sipariş numarası
totalPrice — Sipariş tutarı
affiliateRef — Referral kodu (varsa)

🔗 İdeasoft Entegrasyonu

1
İdeasoft admin panelinde API Ayarları → Sipariş Bildirimi bölümüne gidin.
2
Webhook URL'sine şunu ekleyin:

https://affiliation.refhub.com.tr/api/webhook/ideasoft/API_ANAHTARINIZ

🔗 WooCommerce Entegrasyonu

WooCommerce için hazır plugin kullanın:

AffiliateHub WooCommerce Plugin

Otomatik kurulum, kolay ayarlar

İndir

📡 API Endpoints

POST /api/track/sale

Satış kaydı oluşturur. tracker.js tarafından kullanılır.

Parametre	Tip	Zorunlu	Açıklama
`api_key`	string	Evet	API anahtarı
`order_id`	string	Evet	Benzersiz sipariş ID
`amount`	number	Evet	Sipariş tutarı
`ref`	string	Evet	Referral slug
`product_id`	string	Hayır	Ürün ID
`product_name`	string	Hayır	Ürün adı

⚠️ Hata Kodları

HTTP Kodu	Hata	Açıklama
200	success: true	İşlem başarılı
401	Geçersiz API anahtarı	API anahtarı hatalı veya eksik
404	Referral bulunamadı	ref parametresi geçersiz
200	note: Zaten kayıtlı	Aynı sipariş daha önce kaydedilmiş
422	Validation error	Zorunlu parametreler eksik