App Store Connect API anahtarı nasıl oluşturulur?
Yusuf Yılmaz · 16 Kasım 2026 · 8 dk okuma
API erişimini bir kez Account Holder (hesap sahibi) ister. Sonra Admin rolündeki biri Users and Access → Integrations → App Store Connect API → Team Keys yolundan bir ekip anahtarı oluşturur, rolünü seçer ve yalnızca bir kez indirilebilen özel anahtarı (.p8) indirir. Bir aracın ihtiyacı üç şeydir: sayfanın üstündeki Issuer ID, anahtarın Key ID'si ve .p8 dosyası. İşi gören en dar rolü seç: analiz raporlarını okumak Sales and Reports ya da Finance rolüyle olur, ama yeni bir analiz raporu talebi oluşturmak Admin ister.
App Store Connect API nedir?
App Store Connect API, App Store Connect'te ve Apple Developer sitesinde elle yaptığın işleri otomatikleştiren bir REST API'dir. TestFlight, uygulama içi satın almalar ve abonelikler, provisioning, uygulama metadata'sı, kullanıcılar ve erişim, kullanıcı yorumları ve satış ile finans raporları dahil raporlama bu kapsamdadır.
Her istek, App Store Connect hesabından aldığın bir API anahtarıyla imzaladığın JSON Web Token (JWT) ile yetkilendirilir. Bu anahtarlar yalnızca bu API'de çalışır, Apple'ın başka servislerinde kullanılamaz. Apple ayrıca API ile yaptığın değişikliklerin gerçek (production) verini etkilediği konusunda uyarır; yazma yetkisi olan bir anahtara kendi girişin kadar ciddi yaklaş.
Ekip anahtarı mı, bireysel anahtar mı?
İki tür anahtar var:
- Ekip anahtarları (Team Keys) hesabındaki tüm uygulamalara erişir; yetkilerini seçtiğin rol belirler. Bir ekip anahtarını tek bir uygulamayla sınırlayamazsın.
- Bireysel anahtarlar (Individual API Key) onu oluşturan kullanıcının erişimini ve rollerini taşır. Her kullanıcının aynı anda tek bir etkin bireysel anahtarı olabilir. Bireysel anahtarlar Provisioning uç noktalarını, Sales and Finance verilerini ve notarytool'u kullanamaz.
Bir analiz ya da raporlama aracı için son madde belirleyicidir: araç günlük satış raporlarını okuyorsa ekip anahtarı gerekir. Bireysel anahtarlar Issuer ID de kullanmaz; Issuer ID isteyen bir araç ekip anahtarı bekliyor demektir.
API erişimini istemek (Account Holder)
Kimse anahtar oluşturmadan önce Account Holder'ın API erişimi istemesi gerekir. Bu, tüm hesap için bir kerelik bir adımdır:
- App Store Connect'te Users and Access'i (Kullanıcılar ve Erişim) aç ve Integrations'a tıkla.
- Request Access'e tıkla.
- Koşulları kabul et ve Submit'e tıkla.
Apple bu talepleri tek tek inceler. Tek kişilik bir hesapta Account Holder genelde sensin. Erişim açıldıktan sonra Account Holder ya da Admin ekip anahtarı oluşturabilir.
Ekip anahtarı oluşturma
App Store Connect'te Admin hesabın olmalı. Sonra:
- Users and Access'i, ardından Integrations sekmesini seç.
- Soldaki sütunda App Store Connect API'yi seç.
- Team Keys sekmesinin seçili olduğundan emin ol.
- Generate API Key'e ya da Ekle (+) düğmesine tıkla.
- Bir ad gir. Ad yalnızca senin içindir; anahtarı kullanacak araç ve cihaza göre adlandır, örneğin "Meyu raporlama – iPhone".
- Access altında rolü seç.
- Generate'e tıkla.
Yeni anahtarın adı, Key ID'si ve bir indirme bağlantısı sayfada görünür. Anahtarın adını ve erişim düzeyini sonradan değiştiremezsin; değiştirmek için anahtarı iptal edip (revoke) yenisini oluşturman gerekir. Birden fazla ekip anahtarı oluşturabildiğin için her araca ayrı anahtar vermek iyi bir alışkanlıktır: birini iptal ettiğinde diğerleri bozulmaz.
API rolleri ve izinleri
Anahtarın rolü, API'nin hangi bölümlerine erişebileceğini ve neleri değiştirebileceğini belirler. Anahtar rolleri, ekibindeki kullanıcıların rolleriyle aynıdır. Unutma: ekip anahtarı rolü ne olursa olsun tüm uygulamalara erişir, yani onu sınırlamanın tek yolu roldür. Raporlama açısından önemli roller için Apple'ın belgeleri şunu söylüyor:
| ROL | APPLE NE DİYOR | ANALİZ RAPORU TALEPLERİ | NE ZAMAN KULLANILIR |
|---|---|---|---|
| Admin | Geniş yetkiler; örneğin kullanıcı ekleyip silebilir. | Talep oluşturur ve siler; raporları listeler ve indirir | Aracın yeni bir analiz raporu talebi oluşturması gerekiyorsa |
| Finance | Analiz raporlarını listeleyip indirebilir. | Talep oluşturamaz, silemez | Araç yalnızca var olan raporları indiriyorsa |
| Sales and Reports | Analiz raporlarını listeleyip indirebilir, satış raporlarına erişir ama finans raporlarına erişemez. Apple, raporlarını incelemesi için üçüncü bir tarafla paylaştığın anahtarlarda bu rolü önerir. | Talep oluşturamaz, silemez | Üçüncü taraf yalnızca rapor okuyorsa |
| Diğer roller | App Manager, Developer, Marketing ve diğerleri aynı adlı ekip rolleriyle eşleşir. | Apple'ın analiz raporları için saydığı roller arasında yok | Raporlama dışındaki otomasyonlar; çağırdığın her uç noktanın belgesine bak |
Issuer ID nerede?
Users and Access'i, ardından Integrations sekmesini seç. Issuer ID sayfanın üst kısmında, anahtar listesinin üstünde, yanında Copy düğmesiyle görünür. Apple'ın örneğindeki 57246542-96fe-1a63-e053-0824d011072a gibi uzun bir UUID'dir. Token'a "issuer" (yayımlayan) olarak girer; bu yüzden araç onu Key ID ile birlikte ister. Bireysel anahtarlar Issuer ID kullanmaz.
Key ID nerede?
Aynı Integrations sayfasında Key ID'ler Active başlığı altındaki bir sütunda listelenir. Bir Key ID'nin yanına imleci getirince Copy Key ID bağlantısı çıkar; ona tıkla. Key ID, Apple'ın örneğindeki 2X9R4HXF34 gibi kısadır.
Birden fazla ekip anahtarın varsa Apple'ın tavsiyesi, aracın imzalarken kullandığı özel anahtarla aynı anahtarın Key ID'sini kullanmaktır. Araçlar bu bilgilerle kısa ömürlü token'lar da üretir; Apple çoğu istekte 20 dakikadan uzun geçerli token'ları reddeder. Bu yüzden araç token'ı saklamaz, gerektikçe yenisini imzalar.
Özel anahtarı indirmek ve saklamak
Anahtarı oluşturduktan hemen sonra yanında Download API Key bağlantısı çıkar. Özel anahtarı (.p8) yalnızca bir kez indirebilirsin; indirdiğinde bağlantı kaybolur ve Apple bir kopyasını tutmaz. Dosyayı kaybedersen kurtarmanın yolu yok: anahtarı iptal et ve yenisini oluştur.
Onu bir şifre gibi sakla:
- İndirilenler klasöründe ortada bırakma; bir şifre yöneticisinde ya da sistem anahtar zincirinde tut.
- Kod deposuna gönderme, sohbete yapıştırma, dağıttığın bir uygulamanın içine koyma.
- Yalnızca güvendiğin araçlara ver ve her birinin onu nerede tuttuğunu bil.
Anahtarın sızdığından şüpheleniyorsan App Store Connect'te hemen iptal et. İptal edilen anahtar geri getirilemez; son 30 günde iptal edilenler Revoked bölümünde listelenir.
Analiz raporu talepleri
API'deki analiz verisi, örneğin App Store etkileşim (engagement) raporları, basit bir "sayılarımı getir" çağrısıyla gelmez. Önce biri uygulama için bir analiz raporu talebi (report request) oluşturur. Apple bu talebi karşılamak için raporlar üretir; araç da bu raporları listeler, ayrıntı düzeyine (günlük, haftalık, aylık) ve tarihe göre örnekleri seçer ve rapor dosyalarını indirir.
İki erişim türü var. ONGOING en yaygın olanıdır: güncel veriyle günlük, haftalık ve aylık raporlar üretmeye devam eder. ONE_TIME_SNAPSHOT talep ettiğin gün mevcut olan geçmiş veriyi toplar, sonrasında yeni veri üretmez. Uzun süre kimse veri çekmezse sürekli bir talep stoppedDueToInactivity durumuna geçebilir; devam etmek için yeni talep gerekir.
Yeni analiz raporu talebi için neden Admin gerekir?
Apple'ın analiz raporları için verdiği rol tablosu açık. Rapor taleplerini yönetmek, yani oluşturmak (POST /v1/analyticsReportRequests) ve silmek yalnızca Admin rolüne açık. Finance ve Sales and Reports, bir talebin ürettiği raporları listeleyip indirebilir ama talep oluşturamaz.
Yani Admin, API'deki her iş için değil, bu tek işlem için gerekir. Zaten var olan bir talebin raporlarını yalnızca okuyan bir araç daha dar bir rolle çalışabilir; Apple da üçüncü bir tarafla paylaştığın anahtarda Sales and Reports rolünü önerir. Uygulaman için henüz talep olmadığından talebi kendisi oluşturması gereken bir araç ise Admin anahtarı ister. Böyle bir anahtarı vermeden önce aracın onunla başka ne yaptığına ve onu nerede sakladığına bak.
AsoGlass ikinci türe bir örnek. App Store Connect bağlantısı isteğe bağlıdır; Issuer ID'yi, .p8 dosyasını (Key ID dosya adından kendiliğinden dolar) ve vendor number'ını Ayarlar → Bağlantılar'a eklersin. Sales and Trends'ten günlük indirmeler için gereken vendor number, Reports'ta sol üstte, tüzel kişi adının (Legal Entity Name) altında yazar; Account Holder, Admin ve Finance rolleri görebilir. AsoGlass yalnızca veri okur, tek bir istisnayla: Apple'ın gösterim verisini üretmeden önce şart koştuğu analiz raporu talebini oluşturur; anahtarın Admin rolünde olması bu yüzden gerekir. Anahtar iPhone'un anahtar zincirinde (Keychain) saklanır ve yalnızca iPhone'undan doğrudan Apple'a giden imzalı isteklerde kullanılır; arada bir AsoGlass sunucusu yoktur. Sonrasında ülkelere göre günlük indirmeleri, gösterimi, ürün sayfası görüntülemeyi ve indirmelerin App Store aramasından gelen payını görürsün. Destek sayfasında aynı kurulum dört adımda var; anahtarın nerede durduğunu gizlilik politikası, geri kalanını sık sorulan sorular anlatıyor.
Raporlar ne zaman gelir?
Yeni bir anahtar veriyi hemen getirmez. Apple'a göre ilk analiz raporu, talepten bir iki gün sonra üretilir; sürekli raporlar ondan sonra her gün gelir. Satış raporlarının kendi takvimi vardır. Her sayının ne anlama geldiğini, hangi raporun ne zaman geldiğini ve raporu olmayan bir günün neden sıfır olmadığını App Store Connect metrikleri rehberi anlatıyor.
Hesabını yaklaşan bir uygulama adı, alt başlık ya da anahtar kelime alanı değişikliğini ölçmek için bağlıyorsan, bunu değişikliği yayınlamadan önce yap. Değişiklikten önceki birkaç haftalık veri sana bir başlangıç noktası verir; ayrıntısı metadata değişikliklerini ölçme rehberinde.
Sık sorulanlar
Her anahtar için Account Holder gerekir mi?
Hayır. API erişimini yalnızca Account Holder isteyebilir ama bu bir kerelik bir adımdır. Sonrasında Account Holder ya da Admin ekip anahtarı oluşturabilir.
Anahtarın rolünü sonradan değiştirebilir miyim?
Hayır. Oluşturduktan sonra anahtarın adını ve erişim düzeyini değiştiremezsin. Anahtarı iptal edip ihtiyacın olan rolle yenisini oluştur.
.p8 dosyasını kaybettim. Yeniden indirebilir miyim?
Hayır. Özel anahtar yalnızca bir kez indirilebilir ve Apple bir kopyasını tutmaz. Eski anahtarı iptal et ve yenisini oluştur.
Her API çağrısı Admin anahtarı mı ister?
Hayır. Analiz raporlarında Admin, rapor talebi oluşturmak ya da silmek için gerekir. Raporları listelemek ve indirmek Finance ya da Sales and Reports rolüyle de olur. API'nin diğer bölümlerinin kendi rol gereksinimleri vardır.
Satış verisi için bireysel anahtar kullanabilir miyim?
Hayır. Bireysel anahtarlar Sales and Finance verilerine erişemez; günlük satış raporlarını okuyan bir araç ekip anahtarı ister.