Yetkilendirme

API isteklerinizi, Authorization başlığında gizli API anahtarınızla kimlik doğrulamanız gerekir. Bu anahtarı App Settings sayfasında bulabilirsiniz. Format şu şekildedir: Api-Key {YOUR_SECRET_API_KEY}, örneğin: Api-Key secret_live_....

İstek formatı

Başlıklar

Sunucu tarafı API istekleri, belirli başlıklar ve bir JSON gövdesi gerektirir. İsteklerinizi yapılandırmak için aşağıdaki ayrıntıları kullanın:

Başlık	Açıklama
Content-Type	(Zorunlu) API’nin isteği işleyebilmesi için application/json olarak ayarlayın.
Adapty-Tz	(İsteğe bağlı) Verilerin nasıl gruplandırılacağını ve görüntüleneceğini tanımlamak için saat dilimini ayarlayın. IANA Saat Dilimi Veritabanı formatını kullanın (ör. Europe/Berlin).

Gövde

API, istek için gerekli verileri içeren JSON formatında bir gövde bekler.

Hız limitleri

Uygulama başına saniyede maksimum 2 istek gönderebilirsiniz. Aynı uygulamanın tüm API anahtarları bu limiti paylaşır; yani yeni bir anahtar eklemek kapasiteyi artırmaz. Limiti aşmanız durumunda 429 Too Many Requests hatası döner.

Adapty ayrıca tüm uygulamalar genelinde API’nin toplam trafiğini de sınırlandırır; bu nedenle uygulamanız kendi limitinin altında olsa bile zaman zaman 429 hatası alabilirsiniz. Yanıtta Retry-After başlığı bulunmaz. Bu durumdan kurtulmak için bir dakikaya kadar bekleyin, ardından üstel geri çekilme (exponential backoff) ile tekrar deneyin.

API anahtarlarını yenileme

Gizli API anahtarlarını yenilemek için:

1. Settings → General sayfasında Generate new key butonuna tıklayın, ardından eski anahtarın yanındaki çöp kutusu simgesine tıklayın.
2. Uygulamanızda kullanılan anahtarı güncelleyin.

---

Sırada ne var: İstekler:

• Analitik verilerini al
• Kohort verilerini al
• Dönüşüm verilerini al
• Huni verilerini al
• Yaşam Boyu Değer (LTV) verilerini al
• Elde tutma verilerini al