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_....

Important

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ık	Açı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 iOS, Android, React Native, Flutter ve Unity ş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-Type	API’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ı

Hız sınırları API anahtarı başına uygulanır ve uygulamanıza uygulanan sınır, anahtarınıza atanır — her uygulama için geçerli tek bir rakam yoktur. Yüksek hacimli bir entegrasyon planlıyorsanız veya 429 yanıtları almaya başladıysanız, uygulamanıza hangi sınırın uygulandığını öğrenmek için destek ekibiyle iletişime geçin.

Tasarım yaparken göz önünde bulundurulması gereken iki şey:

Limit, dakikalık bir bütçe değil, sürekli bir hızdır. İstekler, zaman penceresi boyunca düzleştirilir ve yalnızca kısa bir ani artış emilir; bu nedenle sabit bir istek hızı, bir dakikalık trafiği tek seferde göndermekten çok daha verimlidir.
Bazı endpoint’lerin kendi, daha düşük limiti vardır. Sanal para birimi işlemi oluşturma, uygulamanızın genel limitinden bağımsız olarak varsayılan olarak uygulama başına dakikada 600 istek sınırına sahiptir.

Limitin üzerindeki istekler 429 Too Many Requests hatasıyla başarısız olur. Backoff uygulayarak yeniden deneyin ve yanıtta Retry-After başlığı varsa bunu göz önünde bulundurun.

API anahtarlarını yenileme

Gizli API anahtarlarını yenilemek istiyorsanız:

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.
Uygulamanızda kullanılan anahtarı güncelleyin.

Sıradaki adım: istekler: