Kimlik Doğrulama
API anahtarı ile Bearer token yetkilendirmesi.
Tüm istekler bir API anahtarı ile yetkilendirilir. Anahtarı Authorization
header'ında Bearer token olarak gönder:
Authorization: Bearer <API_KEY>Örnek:
curl -s 'https://reporting.magfiads.com/v1/report?from=2026-06-01T00:00:00Z&to=2026-06-07T23:59:59Z&metrics=views' \
-H 'Authorization: Bearer <API_KEY>'IP whitelist
API anahtarı tek başına yeterli değildir. Her anahtar bir IP whitelist (izin verilen IP listesi) ile sınırlıdır — istekler yalnızca önceden kayıtlı IP adreslerinden kabul edilir. Listede olmayan bir IP'den gelen istek, anahtar geçerli olsa bile reddedilir.
Bu yüzden API'yi sabit (statik) çıkış IP'sine sahip bir sunucudan çağır. Çıkış IP'n değişirse erişim kesilir — yeni IP'yi whitelist'e eklettirmen gerekir (İletişim).
Kurallar
- Her anahtar bir reklamverene bağlıdır — yalnızca sahip olduğun kampanya/reklam verisini görürsün.
- Anahtarı sunucu tarafında tut. Tarayıcı/mobil uygulamada gömme; bu anahtar istek atan herkese tüm hesabının verisini açar.
- Anahtar sızarsa rotasyon (yenileme) talep et (İletişim).
Erişim talebi (API anahtarı & IP whitelist)
API anahtarı oluşturma, anahtar rotasyonu veya IP whitelist'e yeni adres ekleme/çıkarma talepleri için bizimle iletişime geç:
Talebinde şunları belirt:
- Reklamveren / hesap adın
- İstek türü: yeni anahtar · rotasyon · IP ekle/çıkar
- IP whitelist için: izin verilecek statik çıkış IP adres(ler)in
Hatalar
| Durum | Anlamı |
|---|---|
401 Unauthorized | Anahtar eksik, geçersiz veya süresi dolmuş |
403 Forbidden | Anahtar geçerli ama erişim yok — IP whitelist dışı veya başka kaynak |
Detay için → Hatalar.