API: bağlantı ve veri okuma
AffiliateCore entegrasyonuna hazırlık: erişim belirteçleri, izinler, istekler, sayfalama, dönüşüm kayıtları ve hata yönetimi.
API v1, 10 Ekim 2026 tarihinde açıldı. Kendi rolünüzün ve projenizin verilerini okuyabilirsiniz. Yetkili hesap sahibi panelde belirteç oluşturur; rehber bağlantısı izin vermez.
Hangi veriler okunabilir?
API kendi entegrasyonunuz için salt okunurdur. Yayıncılar kullanılabilir teklif kataloğunu, kendi kampanya ve dönüşümlerini okur. Reklamverenler kendi proje, teklif, kampanya ve dönüşümlerini okur. Analiz gün ve duruma göre dönüşüm kayıtlarını sayar; ziyaretçi, ham tıklama, gelir veya bakiye değildir. Bu sürüm teklif oluşturmaz, kampanya etkinleştirmez, bakiye yüklemez veya para çekmez.
Nasıl bağlanılır
- Doğru rolle giriş yapın, e-postayı doğrulayın ve hesap gerekliliklerini tamamlayın.
- Hesap ve ayarlar → API erişimi bölümünü açın. Reklamveren seçilen projenin sahibi olmalıdır; yönetici veya finans üyeliği tek başına yeterli değildir.
- Entegrasyonu adlandırın, en az gerekli izinleri seçin ve mevcut parolayı doğrulayın. Yayıncı özeti için
publisher:analytics:readyeterlidir. - Belirteci hemen güvenli saklayın: tekrar gösterilemez. Süresi 30 gündür; kullanıcı/bağlam başına en fazla beş etkin belirteç. Başka rol veya proje için ayrı belirteç gerekir.
- Yalnızca HTTPS üzerinden
Authorization: Bearerbaşlığıyla gönderin. URL, herkese açık JavaScript, mesaj veya günlüklerde kullanmayın. MFA etkinken bu sürüm belirteç vermez; korumayı kapatmak yerine desteğe başvurun.
İstek ve yanıt
Eğitim örneği yayıncı içindir. YOUR_TOKEN yer tutucudur. Reklamveren yolunda slug yerine kendi projenizin sayısal ID değeri kullanılır. İzinler bağımsızdır: analiz izni tekil dönüşümleri dışa aktarmaya yetmez.
GET /api/v1/publisher/analytics?from=2026-10-01&to=2026-10-07
Host: affiliate-core.com
Authorization: Bearer YOUR_TOKEN
Accept: application/json
| GET | Scope |
|---|---|
/api/v1/publisher/offers |
publisher:offers:read |
/api/v1/publisher/campaigns |
publisher:campaigns:read |
/api/v1/publisher/conversions |
publisher:conversions:read |
/api/v1/publisher/analytics |
publisher:analytics:read |
/api/v1/advertiser/{id}/company |
advertiser:company:read |
/api/v1/advertiser/{id}/offers |
advertiser:offers:read |
/api/v1/advertiser/{id}/campaigns |
advertiser:campaigns:read |
/api/v1/advertiser/{id}/conversions |
advertiser:conversions:read |
/api/v1/advertiser/{id}/analytics |
advertiser:analytics:read |
Sayfalama ve tarihler
Listeler data ve meta.next_cursor döndürür. per_page varsayılan 25, aralık 1–100. Dönen cursor değerini aynı filtreler ve sayfa boyutuyla next_cursor=null olana kadar kullanın. İmleci oluşturmayın veya çözmeyin. Detay ve analiz yanıtları data içindedir.
Dönüşüm ve analiz için from/to, YYYY-MM-DD biçiminde UTC tarihidir; iki gün de dahildir. En fazla 30 takvim günü; varsayılan son 30 gün. Gelecek tarihler reddedilir. event_at kullanılır. 1–7 Ekim yedi, 10 Eylül–9 Ekim 30 gündür. Uzun geçmişi ayrı aralıklara bölün.
Teklifler: status, payout_model; kampanyalar: status, offer_id; dönüşümler: status, event_type, offer_id, campaign_id, from, to. Analiz son beşini status olmadan kabul eder. Detay ve company sorgu parametresi kabul etmez. Bilinmeyen alanlar 422 verir. Başarılı sıfır, kayıt olmadığını belirtir; 503 sıfır dönüşüm değildir.
Hatalar ve bakım
401: belirteç/süre; 403: izinler/hesap; 404: nesne yok, erişilemiyor veya API kapalı; 405: desteklenmeyen yöntem; 422: parametreler; 429: Retry-After bekleyin; 503: artan gecikmeyle tekrar deneyin. 401/403'ü sonsuz tekrarlamayın.
Kullanıcının tüm belirteçlerinde dakikada 60 istek; analiz için ayrıca kullanıcı/bağlam başına dakikada 10. Yenilemede yeni belirteç oluşturun, entegrasyonu güncelleyin, eskisini iptal edin. Parola değişimi mevcut belirteçleri geçersiz kılar. Sızan belirteci hemen iptal edin.
Kısa dönemle başlayın, aynı UTC aralığında kayıt ve durumları panelle karşılaştırın. Son başarılı eşitleme ve hataları ayrı tutun. Desteğe gizli bilgi içermeyen yol, saat, yanıt kodu ve anonim açıklama verin.