Reporting API

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>'

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 hesap yöneticinle rotasyon (yenileme) talep et.

Hatalar

DurumAnlamı
401 UnauthorizedAnahtar eksik, geçersiz veya süresi dolmuş
403 ForbiddenAnahtar geçerli ama istenen kaynağa erişim yok

Detay için → Hatalar.

On this page