Sunucu Taraflı API Yetkilendirme ve İstek Formatı

Yetkilendirme

API isteklerinin kimlik doğrulaması için gizli veya genel API anahtarınızı Authorization başlığı olarak kullanmanız gerekir. Bu anahtarları App Settings bölümünde bulabilirsiniz. Değerin biçimi Api-Key {your-secret-api-key} şeklindedir; örneğin Api-Key secret_live_....

API anahtarları uygulamaya özeldir. Birden fazla uygulamanız varsa her biri için farklı anahtarlar kullandığınızdan emin olun.

İstek formatı

Başlıklar

Sunucu taraflı 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ıkAçıklama
adapty-profile-id

Kullanıcının Adapty profil ID’si. Adapty Dashboard -> Profiles -> ilgili profil sayfasındaki Adapty ID alanında görüntülenir.

adapty-customer-user-id ile birbirinin yerine kullanılabilir; ikisinden birini tercih edebilirsiniz.

adapty-customer-user-id

Kullanıcının sisteminizde kayıtlı ID’si. Adapty Dashboard -> Profiles -> ilgili profil sayfasındaki Customer user ID alanında görüntülenir.

adapty-profile-id ile birbirinin yerine kullanılabilir; ikisinden birini tercih edebilirsiniz.

⚠️ Yalnızca uygulama kodunuzda Adapty SDK aracılığıyla kullanıcıları identify users in your app şeklinde tanımladığınızda çalışır.

adapty-platform(isteğe bağlı) Uygulamanın yüklü olduğu cihazın platformunu belirtir. Bu parametreyi, Installation Meta nesnesini güncellerken Create profile ve Update profile isteklerinde ayarlamanızı öneririz; çünkü bu değer kullanıcının kullandığı cihaza bağlıdır ve tek bir kullanıcının birden fazla cihazı olabilir. Olası değerler: iOS, macOS, iPadOS, visionOS, Android veya web.
Content-TypeAPI’nin isteği işleyebilmesi için application/json olarak ayarlayın.

Gövde

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

Hız Sınırları

Kısıtlamayla karşılaşmamak için istek sayısını (uygulama başına) dakikada 40.000’in altında tutun.

Bu sınır aşılırsa, tüm kullanıcılar için optimum performansı korumak amacıyla sistem yavaşlayabilir ya da gelen istekleri geçici olarak engelleyebilir.

API anahtarlarını yenileme

Gizli API anahtarlarını yenilemek istiyorsanız:

  1. Settings → General bölümünde Generate new key seçeneğine 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ıradaki adım: istekler: