İçeriğe geç

Nasıl yapılır

Fiyatlandırma için App Store Connect API anahtarı oluşturma

Sizin adınıza fiyat değiştiren her araç — kendi betiğiniz ya da RepriceCat — bir App Store Connect API anahtarıyla kimlik doğrular. İşi yapabilen ve işten fazlasını yapamayan bir anahtarı nasıl oluşturacağınızı burada bulabilirsiniz.

Güncellendi: 7 dk okuma

Kısa yanıt

App Store Connect’te Kullanıcılar ve Erişim → Entegrasyonlar → App Store Connect API → Ekip Anahtarları’na gidin ve App Manager rolüyle (satış raporlarını da istiyorsanız Admin) bir anahtar oluşturun. .p8 dosyasını indirin — yalnızca bir şansınız var — ve Key ID ile Issuer ID’yi kopyalayın. Bu üç değer kimlik bilgisidir.

Anahtarı adım adım oluşturma

Apple’ın adımları (Apple: API anahtarları oluşturma) bir Admin hesabı gerektirir; ekibinizde API hiç kullanılmadıysa önce Account Holder’ın ona erişim talep etmesi gerekir.

  1. App Store Connect’te oturum açın, Kullanıcılar ve Erişim’i açın ve Entegrasyonlar sekmesini seçin.
  2. Sol sütunda App Store Connect API’yi seçin ve Ekip Anahtarları sekmesinin seçili olduğundan emin olun.
  3. API Anahtarı Oluştur’a veya ekle düğmesine (+) tıklayın.
  4. Daha sonra tanıyacağınız bir ad girin, örneğin “Pricing — RepriceCat”. Ad yalnızca sizin başvurunuz içindir.
  5. Erişim altında rolü seçin (aşağıdaki tabloya bakın), ardından Oluştur’a tıklayın.
  6. Yeni anahtarın yanındaki API Anahtarını İndir’e tıklayın. Özel anahtar bir kez, genellikle AuthKey_2X9R4HXF34.p8 gibi adlandırılmış bir .p8 dosyası olarak iner; Apple bir kopya tutmaz ve bağlantı indirdikten sonra kaybolur.
  7. Key ID’yi Etkin anahtarlar listesinden, Issuer ID’yi sayfanın üst kısmına yakın yerden kopyalayın.
DeğerNeye benzerNerede bulunur
Issuer IDBir UUID, örn. 57246542-96fe-1a63-e053-0824d011072aApp Store Connect API sayfasının üstü; her ekip anahtarı için aynı
Key ID10 karakter, örn. 2X9R4HXF34Etkin listesinde anahtarın yanı
Özel anahtar-----BEGIN PRIVATE KEY----- ile başlayan bir .p8 metin dosyasıİndirmeniz; yeniden indirilemez

Örnekler, Apple’ın belirteç belgelerindeki kendi örnek değerleridir.

Anahtarın hangi rolü olmalı?

Bir ekip anahtarının rolü ne yapabileceğini belirler ve ekip anahtarları role bakılmaksızın tüm uygulamalara erişebilir. Apple’ın fiyatlandırma yardım sayfaları, uygulama, uygulama içi satın alma ve abonelik fiyatlarını değiştirmek için gerekli rol olarak Account Holder, Admin veya App Manager’ı listeler (Apple: fiyat belirleme, Apple: rol izinleri).

RolFiyat değiştirebilirSatışlar ve Eğilimler raporlarıFiyatlandırma için kullanılır mı?
App ManagerEvetApple bu rol için açıklamıyorEvet — fiyatlandırmayı yöneten en küçük rol
AdminEvetEvetEvet, aynı anahtar satış raporlarını da okuyacaksa
FinanceHayırEvetHayır — yalnızca raporlar
SalesHayırEvetHayır — yalnızca raporlar
Developer, Marketing, Customer SupportHayırApple açıklamıyorHayır

Admin anahtarları güçlüdür — Apple kullanıcı oluşturup silebildiklerini belirtir — bu yüzden aynı anahtardan satış verisine ihtiyacınız yoksa App Manager kullanın. Ülke bazında satışları okumak satıcı numarası ve satış raporları rehberinde anlatılıyor.

Ekip anahtarları ve bireysel anahtarlar

App Store Connect ikisini de sunar. Fiyatlandırma için ekip anahtarı kullanın:

  • Ekip anahtarlarının açık bir rolü vardır ve onları oluşturan kişi ekipten ayrılsa da varlığını sürdürür.
  • Bireysel anahtarlar tek bir kullanıcının erişimini ve rollerini taşır ve o kullanıcının profilinden oluşturulur — yalnızca bir Admin Bireysel API Anahtarları Oluştur iznini vermişse.
  • Bireysel anahtarlar Sales ve Finance uç noktalarını, provisioning veya notarytool’u kullanamaz; bu yüzden satış raporları için işe yaramazlar.

Anahtara güvenmeden önce test edin

  1. Bir JWT imzalayın: başlık alg ES256 ve kid = Key ID; yük iss = Issuer ID, iat = şimdi, exp = en fazla 20 dakika sonrası, aud = appstoreconnect-v1.
  2. Belirteci bearer başlığı olarak kullanıp GET https://api.appstoreconnect.apple.com/v1/apps çağırın. Uygulamalarınızın bir listesi anahtarın çalıştığı anlamına gelir.
  3. 401 genellikle yanlış bir Issuer ID veya Key ID, farklı bir anahtarla imzalanmış bir belirteç ya da ömrü çok uzun veya süresi çoktan dolmuş bir belirteç demektir (saatinizi kontrol edin).
  4. Bir fiyatlandırma çağrısındaki 403 genellikle anahtarın rolünün fiyatları yönetemediği anlamına gelir — App Manager veya Admin rolüne sahip bir anahtar kullanın.

Çalıştığında, fiyatlandırma API’si rehberi fiyat noktası ve takvim uç noktalarını adım adım anlatır.

Güvenle saklama

  • Bir .p8’i parola gibi ele alın. Ona ve iki kimliğe sahip olan herkes, ekibin her uygulamasında anahtarın rolüyle işlem yapabilir.
  • Apple’ın tavsiyesi: anahtarları paylaşmayın, bir kod deposunda saklamayın ve istemci tarafı koduna eklemeyin.
  • Amaç başına bir anahtar tutun. Bir fiyatlandırma anahtarının CI’ınızın yüklemeler için kullandığı anahtar olması gerekmez; böylece biri diğerini bozmadan iptal edilebilir.
  • Bir araca yapıştırırsanız, aracın onunla ne yaptığını kontrol edin. RepriceCat anahtarı saklamadan önce AES-256-GCM ile şifreler, asla tarayıcıya geri göndermez ve yalnızca kendi hesabınız için kısa ömürlü belirteçleri imzalamakta kullanır.

Sık yapılan hatalar

  • “Daha güvenli göründüğü” için Developer veya Marketing seçmek. Anahtar o zaman veri okur ama her fiyat değişikliği başarısız olur.
  • Profilinizden bireysel bir anahtar oluşturup sonra satış raporlarının neden reddedildiğini merak etmek — bireysel anahtarlar Sales ve Finance uç noktalarını kullanamaz.
  • Key ID ile Issuer ID’yi karıştırmak. Key ID kısadır ve belirteç başlığında kid olarak gider; Issuer ID uzun bir UUID’dir ve yükte iss olarak gider.
  • 20 dakikadan uzun yaşayan belirteçler imzalamak. Apple bunları fiyatlandırma uç noktaları için reddeder; uzun bir iş belirli aralıklarla yeni bir belirteç imzalamalı ve her birini süresi dolana kadar yeniden kullanmalıdır.
  • Özel bile olsa .p8 dosyasını bir depoya göndermek. Onu bir gizli bilgi deposuna taşıyın ve açığa çıkan anahtarı iptal edin.
  • Tek bir anahtarı CI yüklemeleriniz, bir fiyatlandırma betiği ve üçüncü taraf bir araç arasında paylaşmak. Bir nedenle iptal ettiğinizde diğer her şey de bozulur.

Bu anahtarla kendi fiyatlandırma betiğinizi yazıp yazmamaya ya da bir araç kullanmaya mı karar veriyorsunuz? RepriceCat ile API betikleri artıları ve eksileri ortaya koyar.

İptal etme

Biri ayrıldığında, anahtar sızmış olabilirse veya bir aracı kullanmayı bıraktığınızda anahtarı iptal edin. Bir Admin, ekip anahtarlarını Kullanıcılar ve Erişim’deki API anahtarları listesinden iptal edebilir (Apple: API anahtarlarını iptal etme). İptal kalıcıdır: iptal edilen bir anahtar yeniden etkinleştirilemez, onunla imzalanan her belirteç çalışmayı bırakır ve 30 gün boyunca İptal Edilenler altında listelenir. .p8’i kaybederseniz anahtarı iptal edin ve yenisini oluşturun.

Anahtarı RepriceCat ile kullanma

RepriceCat’i bağlamak için App Manager veya Admin rolüne sahip bir ekip anahtarının Issuer ID’si, Key ID’si ve .p8 dosyası gerekir. Bundan sonra:

  • Anahtar beklemede şifrelidir ve App Store Connect’te istediğiniz zaman sizin tarafınızdan iptal edilebilir.
  • Her ürün ve ülkenin gözden geçirmesini onaylayana kadar Apple’a hiçbir şey gönderilmez; bir deneme çalıştırması hiçbir şey göndermez.
  • Satışlar sayfası ayrıca satıcı numaranızı ve Admin, Finance veya Sales rolüne sahip bir anahtarı gerektirir — yani bir Admin anahtarı fiyatlandırmayı ve satışları tek seferde karşılar.

Hazır mısınız? Bir anahtar bağlayın ve ilk uygulamanızı yeniden fiyatlandırın — ilk ay ücretsiz, ardından uygulama başına ayda 1 $.

Sık sorulanlar

Issuer ID’yi nerede bulurum?

App Store Connect’te Kullanıcılar ve Erişim, Entegrasyonlar, App Store Connect API altında. Sayfanın üst kısmına yakındır, bir Kopyala düğmesiyle birlikte, ve hesaptaki her ekip anahtarı için aynıdır.

.p8 dosyasını kaybettim. Yeniden indirebilir miyim?

Hayır. Apple özel anahtarı bir kez indirmenize izin verir ve bir kopya tutmaz. Anahtarı iptal edin ve yenisini oluşturun.

Hangi App Store Connect rolü fiyat değiştirebilir?

Admin ve App Manager, ayrıca Account Holder. App Manager fiyatlandırmayı yöneten en küçük roldür; Developer, Marketing, Finance ve Sales yönetemez.

Bir App Store Connect API anahtarını kim oluşturabilir?

Ekip anahtarları, Account Holder ekip için API erişimi talep ettikten sonra Admin hesabına sahip biri tarafından oluşturulur. Bireysel anahtarlar, bir Admin o izni verdiyse kullanıcının kendi profilinden oluşturulur.

Fiyatlandırma için bireysel bir API anahtarı kullanabilir miyim?

Kullanıcının kendi rolü fiyatlandırmaya izin veriyorsa fiyatlar için çalışır, ama ekip anahtarı daha iyi bir seçimdir: açık bir rolü vardır ve kullanıcı ayrılsa da varlığını sürdürür. Bireysel anahtarlar ayrıca Sales ve Finance raporlarına erişemez.

Bir fiyatlandırma aracına API anahtarımı vermek güvenli mi?

Yalnızca anahtarı nasıl sakladığına güveniyorsanız, çünkü anahtar rolünün izin verdiği her şeyi yapabilir. Çalışan en küçük role sahip özel bir ekip anahtarı kullanın ve aracı kullanmayı bıraktığınızda iptal edin.

Deneyin

Her ülkeyi tek bir temel fiyattan yeniden fiyatlandırın

Kademeler, fiyat noktasına yuvarlama, tek bir gözden geçirme tablosu, tek bir onay — App Store Connect API üzerinden. İlk ay ücretsiz, sonrasında uygulama başına aylık 1 $.