App Store Connect API anahtarı nasıl oluşturulur

Shipcue, inceleme durumunu okur ve sürümleri Apple'ın App Store Connect API'si üzerinden yayınlar. Bunun için takip etmek istediğiniz her hesaptan bir API anahtarına ihtiyaç duyar. Bir anahtarı adım adım nasıl oluşturacağınız aşağıda.

AppLabs.lv · Güncelleme: 28 Ekim 2026

Team anahtarı mı, Individual anahtarı mı?

App Store Connect'te iki tür API anahtarı vardır. Shipcue ikisiyle de çalışır.

• Team anahtarı (önerilen). Ekibin bir Admin'i tarafından oluşturulur. Anahtar için seçtiğiniz rolle ekibin tüm uygulamalarını görebilir. Bir Issuer ID ile gelir.
• Individual anahtarı. Kendi kullanıcı profilinizde oluşturulur. Kullanıcınızla aynı role ve uygulama erişimine sahiptir; yani yalnızca sizin görebildiğiniz uygulamaları görür. Issuer ID'si yoktur. "Generate Individual API Keys" iznine ihtiyacınız var; bunu bir ekip Admin'i verebilir.

Müşteriler için çalışıyorsanız, Individual anahtarı genellikle daha kolay yoldur: Admin'in sizin için anahtar oluşturmasına gerek yok, yalnızca o izne ihtiyacınız var.

Anahtarın hangi rolü olmalı?

İhtiyacınızı karşılayan en küçük rolü seçin:

• App Manager: Shipcue için en uygunu. Sürümleri yayınlayabilir ve geri çekebilir, aşamalı yayınları kontrol edebilir ve push'un ihtiyaç duyduğu webhook'ları kurabilir, ama kullanıcıları yönetemez.
• Admin: o da çalışır ama kullanıcı ekleyip çıkarabilir. Telefonunuzda duracak bir anahtar için bundan kaçının.
• Developer: yalnızca görüntüleme. Shipcue, açtığınızda veya aşağı çekip yenilediğinizde güncel durumu gösterir ama push kuramaz, yayınlayamaz ve geri çekemez.

Yalnızca Shipcue için yeni bir anahtar oluşturun. CI sisteminizin veya diğer araçlarınızın bağlı olduğu bir anahtarı yeniden kullanmayın; böylece birini diğerini bozmadan iptal edebilirsiniz.

Team anahtarı oluşturma

1. API anahtarları sayfasını açın

   App Store Connect'te bir tarayıcıdan Admin olarak oturum açın. Users and Access'i açın, Integrations sekmesini seçin, ardından sol sütunda App Store Connect API'yi seçin. Sayfada Request Access düğmesi görünüyorsa, Account Holder'ın API erişimini bir kez talep etmesi gerekir.

2. Anahtarı oluşturun

   Team Keys'in seçili olduğundan emin olun ve Generate API Key'e (veya + düğmesine) tıklayın. Daha sonra tanıyacağınız bir ad verin, örneğin "Shipcue". Access altında App Manager'ı seçin. Generate'e tıklayın.

3. .p8 dosyasını indirin

   Yeni anahtarın yanındaki Download API Key'e tıklayın. Apple yalnızca bir kez indirmenize izin verir ve bir kopya tutmaz. Dosyanın adı AuthKey_ ile başlar ve Key ID ile devam eder, örneğin AuthKey_ABCD123456.p8. Parola yöneticiniz gibi güvenli bir yerde saklayın.

4. Issuer ID'yi kopyalayın

   Issuer ID, anahtar listesinin üstünde gösterilir. 69a6de8f-3c2e-47e3-e053-5b8c7c11a4d1 gibi görünür. Shipcue, Team anahtarı için buna ihtiyaç duyar.

Individual anahtarı oluşturma

1. Profilinizi açın

   App Store Connect'te kullanıcı profilinizi açın ve Individual API Key bölümüne kadar aşağı kaydırın. Generate API Key düğmesi yoksa, bir ekip Admin'inden "Generate Individual API Keys" iznini isteyin.

2. Oluşturun ve indirin

   Generate API Key'e, sonra Download API Key'e tıklayın. Team anahtarlarında olduğu gibi, .p8 dosyası yalnızca bir kez indirilebilir. Individual anahtarının Issuer ID'si yoktur.

Anahtarı Shipcue'ya ekleyin

1. Add Account'u başlatın

   Shipcue'da Add Account'a dokunun. .p8 dosyasını Dosyalar'dan seçin, Mac'inizden AirDrop ile gönderip Shipcue'yu seçin veya anahtar metnini yapıştırın.

2. Ayrıntıları kontrol edin

   Dosya hâlâ AuthKey_ adını taşıyorsa Shipcue Key ID'yi sizin için doldurur. Team anahtarı için Issuer ID'yi yapıştırın, Individual anahtarı için boş bırakın. Hesaba tanıyacağınız bir ad verin, örneğin "Client: Acme".

3. Shipcue'nun Apple ile kontrol etmesine izin verin

   Shipcue, App Store Connect'e anahtarın hangi uygulamaları görebildiğini sorar. Yepyeni bir anahtarın çalışmaya başlaması bir iki dakika sürebilir; Shipcue denemeye devam eder.

4. Uygulamalarınızı seçin

   Takip edeceğiniz uygulamaları seçin. Shipcue Pro ile Shipcue, durum değişiklikleri size push olarak ulaşsın diye Apple'da uygulama başına bir webhook ekler. Apple uygulama başına 10 webhook'a izin verir, Shipcue 1 tanesini kullanır.

Bilmekte fayda var

• Varsayılan olarak anahtar, Apple tarafından uçtan uca şifrelenen iCloud Keychain'inize kaydedilir; böylece iPhone ve iPad'iniz ikisi de kullanabilir. Bunun yerine bir anahtarı yalnızca tek bir cihazda tutabilirsiniz. Private modunda sunucumuza hiç ulaşmaz.
• Eklediğiniz her App Store Connect hesabı kendi anahtarına ihtiyaç duyar.
• Bir anahtarı her yerde durdurmak için App Store Connect'te iptal edin: Users and Access › Integrations › App Store Connect API, anahtarı seçin, Revoke. Bir cihazı kaybederseniz de ilk adım budur (bkz. Cihazınızı mı kaybettiniz?).
• .p8 dosyanızı veya içeriğini kimseye, bize de dahil, asla göndermeyin.

Sorular

İlgili içerikler

• Onaylı bir uygulamayı iPhone'unuzdan yayınlayınBir sürüm Pending Developer Release olduğunda ne yapmalı.
• App Review durumları ve anlamlarıHer App Store Connect durumu ve sonrasında ne olur.