İçeriğe geç
EN

Kimlik doğrulama ve anahtarlar

Hesabınızda API anahtarı oluşturun, bunları Bearer token olarak gönderin, geçerlilik süresi belirleyin ve artık kullanmadığınız anahtarları iptal edin.

Kayıt ve oturum açma dışındaki her API isteği, Authorization başlığında bir Bearer token gerektirir. Bir script için bunu almanın en kolay yolu, hesap sayfanızdan bir API anahtarı oluşturmaktır.

Tüm örneklerde kullanılan temel URL şudur:

https://ulumob.com/api/v1

Panelde API anahtarı oluşturun

  1. /app/account adresini açın.
  2. API anahtarları altına, anahtarın ne için olduğunu anlatan bir ad yazın; örneğin "raporlama script'i". Adlar en fazla 60 karakter olabilir.
  3. Anahtar oluştur seçeneğini seçin.
  4. Görünen anahtarı kopyalayın ve güvenli bir yerde saklayın.

Anahtar yalnızca bir kez gösterilir. UluMob yalnızca hash değerini sakladığı için anahtar tekrar gösterilemez. Kaybederseniz anahtarı iptal edip yenisini oluşturun.

Anahtar kuralları

  • Bir anahtar hesabınız gibi davranır; oluştururken işaretlediğiniz kapsamlarla sınırlıdır (aşağıya bakın).
  • Bir hesapta en fazla 10 anahtar bulunabilir. Yenisini oluşturmadan önce kullanmadığınız birini iptal edin. API üzerinden oturum açarak alınan token'lar (aşağıya bakın) aynı sınıra dahildir ve aynı listede görünür.
  • Anahtarların süresi dolar. Varsayılan ömür 365 gündür; API üzerinden 1 ile 3.650 gün arasında seçebilirsiniz.
  • Hesap sayfası her anahtarı adıyla, son kullanım zamanıyla ve bitiş tarihiyle listeler.

Anahtarları herkese açık koddan, tarayıcı JavaScript'inden ve paylaşılan belgelerden uzak tutun. Bir anahtarın sızmış olabileceğinden şüpheleniyorsanız hemen iptal edin.

Kapsamlar

Her anahtara yalnızca script'inin ihtiyacı olanı verin. read her zaman dahildir; aksini seçmezseniz yeni anahtarlar read ve reports alır.

Kapsam İzin verdiği
read Her GET: kampanyalar, siteler, reklam alanları, teklif duvarı, linkler, dönüşümler, hesabınız
reports Raporlar, rapor e-postaları ve affiliate istatistikleri (/advertiser/reports, /publisher/reports, /affiliate/stats)
campaigns Diğer her yazma işlemi: kampanyalar, reklamlar, kreatifler, kurallar, listeler, kitleler, siteler ve reklam alanları; affiliate'ler için linkler, trafik kaynakları, postback'ler, erişim talepleri ve favoriler
billing Reklamveren bakiye yüklemeleri (/advertiser/billing/...)
payouts Yayıncı ödeme alma yöntemleri ve ödeme talepleri
account Hesabınızdaki değişiklikler ve destek talepleri

Bir anahtarın kapsamlarının karşılamadığı bir istek, "code": "token_scope" ve gereken kapsamla 403 durum kodu döner. Personel uç noktaları (/admin/...) kapsamlı bir API anahtarına asla açık değildir. Yalnızca teklifler ya da yalnızca linkler gibi daha ince kapsamlar yoktur: teklif duvarını okuyan bir affiliate script'i read, link oluşturan bir script campaigns kapsamına ihtiyaç duyar.

Anahtarı gönderme

Anahtarı Bearer şemasıyla Authorization başlığına koyun ve JSON isteyin:

curl https://ulumob.com/api/v1/me \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Accept: application/json"

GET /me kullanıcı kaydınızı döndürür; yeni bir anahtarı denemenin hızlı bir yoludur.

Anahtarları API üzerinden yönetin

Yöntem ve yol Ne yapar
GET /account/tokens Anahtarlarınızı listeler: id, name, last_used_at, expires_at, created_at. Anahtarların kendisi hiçbir zaman döndürülmez.
POST /account/tokens Bir anahtar oluşturur. Gövde: {"name": "nightly export", "days": 30, "scopes": ["read", "reports"]}. days isteğe bağlıdır, 1 ile 3.650 arasındadır, varsayılanı 365 (bu ayar 0 ise anahtarların süresi dolmaz). scopes isteğe bağlıdır (varsayılan read ve reports).
DELETE /account/tokens/{id} Bir anahtarı iptal eder. Anında çalışmayı bırakır.

Başarılı bir POST, düz anahtarla birlikte yalnızca bir kez 201 durumu döndürür:

{
  "id": 42,
  "name": "nightly export",
  "key": "42|AbCdEf...",
  "expires_at": "2026-11-14T10:00:00.000000Z"
}

Oturum açma token'ları

Oturum açarak da bir token alabilirsiniz:

POST /auth/login
{"email": "[email protected]", "password": "..."}

Yanıt user ve token içerir. Bu token 30 gün geçerlidir. POST /auth/register, hesap oluştururken aynı şekilde bir token döndürür. Oturum açma, diğer endpoint'lerden daha sıkı hız sınırına tabidir; bkz. Hız sınırları ve hatalar.

POST /auth/logout, o istekte kullanılan token'ı iptal eder.

Script'ler için hesap sayfasından adlandırılmış bir API anahtarı tercih edin: tanıyabileceğiniz bir adı vardır, ömrünü siz seçersiniz ve parolanızı saklamanızı gerektirmez.

Roller ve hesap durumu

Endpoint'ler role göre gruplanır:

  • /advertiser/... reklamveren rolü gerektirir.
  • /publisher/... ve /affiliate/... yayıncı rolü gerektirir (her yayıncı hesabı bir affiliate'tir).
  • /me ve /account/... her rol için çalışır.

Hesabınızın sahip olmadığı bir gruba yapılan istek veya aktif olmayan bir hesaptan gelen istek 403 durumu döndürür. Eksik, süresi dolmuş veya iptal edilmiş bir token 401 durumu döndürür.

Sonraki adımlar

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