Affiliate API'si

Teklif duvarını okuyun, link ve smartlink oluşturun, dönüşümleri ve istatistikleri izleyin, postback'lerinizi API ile ayarlayın; her çağrının gerektirdiği anahtar kapsamlarıyla.

Affiliate uç noktaları /affiliate altındadır ve yayıncı rolüne sahip bir hesap gerektirir (her yayıncı hesabı bir affiliate'tir). Yollar https://ulumob.com/api/v1 adresine görelidir. Gönderilecek başlık ve kapsamlar için bkz. Kimlik doğrulama ve anahtarlar.

Kapsam	Çağrılar
`read`	İstatistikler dışında aşağıdaki her `GET`
`campaigns`	Linkleri, trafik kaynaklarını, postback'leri, erişim taleplerini ve favorileri oluşturmak, değiştirmek ve arşivlemek
`reports`	`GET /affiliate/stats`

Teklif duvarı

Yöntem ve yol	Ne yapar
`GET /affiliate/offers`	Görebildiğiniz teklifler, sayfa başına 40. Filtreler: `q`, `country`, `group` (tier1, eu, latam…), `carrier`, `connection=cellular\|wifi`, `vertical=adult\|mainstream`, `category`, `flow`, `traffic_type`, `access`, `payout_min`, `payout_max`, `favorites=1`; `sort=featured\|epc\|payout\|newest`.
`GET /affiliate/offers/{id}`	Tek bir teklif: sizin için her olay ve ülke ödemesi, bekletme, gereksinimler ve yasaklar, benzer teklifler, erişim durumunuz. Göremediğiniz bir teklif için 404.
`POST /affiliate/offers/{id}/access`	Onay gerektiren bir teklifi çalıştırmak için talepte bulunur. Gövde: `{"note": "Pop trafiği, TR ve DE"}`.
`POST` / `DELETE /affiliate/offers/{id}/favorite`	Teklifi sonrası için kaydeder ya da kaldırır.

Her kartta payout (ana olayın sizin için tutarı), standing (open, approved, requested, rejected, none, invite, blocked) ve may_run bulunur. Duvarı read kapsamlı bir anahtarla okuyun:

curl "https://ulumob.com/api/v1/affiliate/offers?country=TR&connection=cellular&sort=epc" \
  -H "Authorization: Bearer ANAHTARINIZ" -H "Accept: application/json"

Trafik kaynakları

GET /affiliate/sources kaynaklarınızı listeler; POST /affiliate/sources bir kaynak ekler: {"name", "type", "description", "urls"}. Türler: website, pop_push_network, social, email, messaging, search, incentive, mobile_app, other. Yeni ya da düzenlenen bir kaynak incelemeyi bekler; linkler onaylı bir kaynak gerektirir.

Linkler ve smartlink'ler

Yöntem ve yol	Ne yapar
`GET /affiliate/link-options`	Bir linkin ihtiyaç duyduğu her şey: kaynaklarınız, sub makrolarıyla ağ hazır ayarları, takip alan adları, kategoriler ve akışlar.
`GET /affiliate/links?type=custom\|smart`	`code` ve `url` ile linkleriniz.
`POST /affiliate/links`	Bir link oluşturur. `url` ile 201 döner.
`PUT /affiliate/links/{id}`	Adı, kaynağı, hazır ayarı, sub değerlerini, trafficback'i, takip alan adını, postback'i, smartlink ayarlarını ya da `status` (`active`, `paused`) değerini değiştirir.
`DELETE /affiliate/links/{id}`	Linki arşivler; kodu çalışmayı bırakır, istatistikleri kalır.

Tek bir teklife link, campaigns kapsamlı bir anahtarla:

curl -X POST https://ulumob.com/api/v1/affiliate/links \
  -H "Authorization: Bearer ANAHTARINIZ" -H "Accept: application/json" -H "Content-Type: application/json" \
  -d '{"type": "custom", "campaign_id": 1042, "name": "TR pops", "traffic_source_id": 7, "source_preset_id": 2,
       "trafficback_url": "https://example.com/tb?r={reason}&s={sub1}"}'

Bir smartlink: {"type": "smart", "name": "Tüm genel teklifler", "traffic_source_id": 7, "smart": {"vertical": "mainstream", "categories": ["vpn"], "geos": ["TR", "DE"]}}. Onaylı bir kaynak yoksa yanıt "code": "source_required" ile 403'tür; çalıştıramadığınız bir teklif 422 döner. Bkz. Linkler ve formatlar ve Smartlink'ler.

Dönüşümler ve istatistikler

Yöntem ve yol	Ne yapar
`GET /affiliate/conversions`	Dönüşümleriniz, sayfa başına 50: teklif, link, olay, durum, ödeme, bekletme, gerekçe, sub ID'ler. Filtreler: `status`, `event`, `offer_id`, `link_id`, `from`, `to`, `sub1`-`sub5`.
`GET /affiliate/conversions/summary`	Bekleyen, onaylanan ve reddedilen sayılar ve tutarlar, bekleyen bakiye ve bekletmelerin bittiği günler.
`POST /affiliate/conversions/{id}/dispute`	Bir redde bir kez itiraz eder: `{"note": "..."}` (10-1.000 karakter).
`GET /affiliate/stats`	Tıklamalar, tekil tıklamalar, geçersiz tıklamalar, trafficback, duruma göre dönüşümler, ödeme, CR ve EPC; `group=day\|offer\|link\|geo\|reason\|sub1`…`sub5`, `from`, `to`, `link_id`, `offer_id`. `reports` gerektirir.

Postback'ler

GET /affiliate/postback, varsayılan postback'lerinizi olaylar, makrolar ve tracker şablonlarıyla döndürür; PUT /affiliate/postback bunları değiştirir: {"postbacks": [{"url": "https://tracker.example/pb?cid={sub1}&p={payout}&s={status}", "events": ["pending", "approved"]}]}. POST /affiliate/postback/test örnek değerlerle bir tane gönderir, GET /affiliate/postback-logs her denemeyi listeler. Bkz. Postback'ler.

Her liste ve hata, Hız sınırları ve hatalar sayfasındaki biçimleri izler.

Eksik ya da hatalı bir şey mi var? Bize bildirin.