2026 İçin App Store Connect API Entegrasyonu Geliştirici Rehberi

Geliştiriciler, uygulama mağazası optimizasyon (ASO) araştırmalarına göre, varlıkları manuel olarak yüklerken her uygulama güncellemesinde 15 saate kadar zaman kaybediyor. 35 farklı dildeki ekran görüntülerini tek tek yönetmek, bağımsız çalışan her geliştirici için gerçekten can sıkıcı bir angaryadır. Bu App Store Connect API entegrasyonu geliştirici rehberi, size bu sürtünmeyi tamamen nasıl ortadan kaldıracağınızı öğretecek. Kimlik bilgilerini nasıl oluşturacağınızı, otomatik bir ardışık düzen (pipeline) nasıl kuracağınızı ve asıl işiniz olan kodlamaya ayıracağınız zamanı nasıl geri kazanacağınızı öğreneceksiniz.

Ayrıca Auto Localizer gibi modern çözümlerin, tüm bu iş akışını doğrudan tasarım ortamınızdan nasıl basitleştirdiğini de keşfedeceğiz. Bu adımları otomatikleştirmek, tekrarlayan veri girişleri yerine ürününüzü büyütmeye odaklanmanızı sağlar. Uygulamanızı küresel çapta ölçeklendirmek, varlık yönetimine (asset management) sistematik bir yaklaşım gerektirir. Bu yazının sonunda, otomasyon yolculuğunuz için net bir yol haritasına sahip olacaksınız.

App Store Connect API Temellerini Anlamak

App Store Connect API, Apple tarafından oluşturulmuş güçlü bir REST API'dir. Bağımsız geliştiricilerin, geleneksel olarak web arayüzünde manuel tıklamalar gerektiren görevleri yürütmesine olanak tanır. Sertifikaları, dağıtım profillerini (provisioning profiles), kullanıcı erişimini ve en önemlisi uygulama meta verilerini ve ekran görüntülerini yönetebilirsiniz. Bu programatik erişim, yorucu bir sürüm yayınlama gününü basit bir terminal komutuna veya otomatik bir betik (script) çalıştırmasına dönüştürür.

Mobil geliştirme verimlilik karşılaştırmalarına göre, meta veri gönderimlerini otomatikleştirmek güncelleme döngü sürelerini %40 oranında azaltabilir. Sağlam bir entegrasyon kurmak, siz yeni özellikler geliştirmeye odaklanırken kodunuzun tekrarlayan yükleme işlemlerini halletmesi demektir. Küresel erişimlerini manuel olarak ölçeklendirmeye çalışan her bağımsız geliştirici er ya da geç bir duvara toslar. Bu API'den yararlanmak, bu sınırlamayı aşmanın en akıllıca yoludur.

Bunu halletmek için farklı yöntemleri değerlendiriyorsanız, 2026 App Store Ekran Görüntüsü Yerelleştirme Araçları Karşılaştırmamızı (App Store Screenshot Localization Tools Comparison 2026) inceleyin. Bu, pazarın neler sunduğunu anlamak için harika bir temel sağlar. Ardından, sürecin ne kadarını kendiniz oluşturmak istediğinize ve mevcut araçları ne kadar kullanacağınıza karar verebilirsiniz. Özel betikler esneklik sunarken, özel eklentiler (plugins) anında hız kazandırır.

App Store Kimlik Bilgileri ve API Anahtarınızı Oluşturma

Herhangi bir kod yazmadan önce, bir API anahtarı (api key) App Store kimlik bilgisi oluşturmanız gerekir. App Store Connect portalına gidin ve Hesap Sahibi (Account Holder) kimlik bilgilerinizle giriş yapın. Kullanıcılar ve Erişim (Users and Access) bölümüne gidin ve ardından Entegrasyonlar (Integrations) sekmesini seçin. Burada API erişimi için özel olarak yeni bir anahtar oluşturma seçeneğini bulacaksınız.

Anahtarınıza bir isim vermeli ve uygun erişim rolünü seçmelisiniz. Ekran görüntülerini ve meta verileri yüklemek için Genellikle Uygulama Yöneticisi (App Manager) veya Geliştirici (Developer) rolü yeterlidir. Oluşturulduktan sonra, özel anahtar (private key) dosyasını hemen indirin. Apple bu dosyayı yalnızca bir kez indirmenize izin verir, bu nedenle güvenli bir yerde saklayın.

Portaldan Veren Kimliğinizi (Issuer ID) ve Anahtar Kimliğinizi (Key ID) de not edin. Betiklerinizin başarıyla kimlik doğrulaması yapabilmesi için özel anahtarın yanı sıra bu iki tanımlayıcıya da ihtiyacı olacaktır. Doğru kimlik bilgisi yönetimi, otomatik sistemlerinizin kimlik doğrulama hataları olmadan sorunsuz çalışmasını sağlar. Bu kurulumu yapmadan önce varlıklarınızı hazırlıyorsanız, 2026'da App Store Yerelleştirmesi İçin Figma Tasarımları Nasıl Hazırlanır (How to Prepare Figma Designs App Store Localization in 2026) yazımıza göz atın.

JWT İçin App Store Connect API Entegrasyonu Geliştirici Rehberi

Görevleri başarıyla otomatikleştirmek için, isteklerinizi JSON Web Token'ları (JWT) kullanarak imzalayan bir betiğe ihtiyacınız vardır. İndirdiğiniz özel anahtar, Anahtar Kimliği ve Veren Kimliğini kullanarak bir JWT oluşturursunuz. Bu token, tüm API uç noktaları (endpoints) için geçici pasaportunuz işlevi görür. Çoğu bağımsız geliştirici, bu token oluşturma işlemini ve sonraki API çağrılarını yönetmek için Python veya Ruby betiklerini kullanır.

Uygulama mağazası optimizasyon verilerine göre, her ay küresel olarak güncellenen uygulamalar, elde tutma (retention) oranlarında %15'lik bir artış görüyor. Bu aylık tempoyu yakalamak, yalnızca yükleme sürecini otomatikleştirirseniz gerçekçi olur. Apple'ın güvenlik gereksinimlerine uymak için tokeninizin sona erme süresi (expiration time) maksimum 20 dakikaya ayarlanmalıdır. Her dağıtım oturumu için yeni bir token oluşturmak en güvenli yaklaşımdır.

Apple hizmetleri için JWT oluşturmayı basitleştiren birçok açık kaynaklı kütüphane mevcuttur. İyi bakımı yapılan bir kütüphane kullanmak, imzalama işlemi sırasındaki yaygın kriptografik hataları önler. Tokeniniz oluşturulduktan sonra, onu her HTTP isteğinin Authorization (Yetkilendirme) başlığına (header) eklemelisiniz. Buradaki basit bir biçimlendirme hatası bile anında yetkisiz erişim yanıtlarına neden olacaktır.

App Store Connect API Hız Sınırlarında (Rate Limits) Gezinme

Hızlı bir betik yazmak heyecan vericidir, ancak hız sınırlarına takılmak iş akışınızı anında durduracaktır. Apple, platform kararlılığını sağlamak için API'lerine katı hız sınırları uygular. Aynı anda çok fazla ekran görüntüsü yükleme isteği gönderirseniz, sunucu 429 Too Many Requests (Çok Fazla İstek) hatası döndürür. Güvenilir bir otomasyon betiği için uygun geri çekilme (backoff) stratejilerini uygulamak şarttır.

Kodunuz, hız sınırı göstergeleri için HTTP yanıt başlıklarını izlemelidir. Bir sınıra yaklaşıldığında, betiğin yürütmeyi otomatik olarak duraklatması gerekir. Üstel geri çekilme (exponential backoff), bu geçici engellemeleri yönetmek için önerilen yeniden deneme (retry) stratejisidir. Bu, betiğinizin istek başarılı olana kadar yeniden deneme girişimleri arasında giderek daha uzun süre beklemesi anlamına gelir.

35 dil için ekran görüntüsü yüklemek yüzlerce ayrı API çağrısı gerektirir. İsteklerinizi mantıksal olarak gruplandırmak ve dil setleri arasına küçük gecikmeler eklemek, sunucuyu bunaltmayı önler. İyi ayarlanmış bir betiğin çalışması fazladan birkaç dakika alabilir, ancak başarılı bir dağıtımı garanti eder. API'yi aceleye getirmek yalnızca başarısız yüklemelerle ve bozuk meta veri durumlarıyla sonuçlanacaktır.

Otomatik Ekran Görüntüsü Yüklemelerinizi Yapılandırma

Görsel varlıkları yüklemek, Apple ekosistemi içinde çok adımlı bir süreçtir. İlk olarak, betiğiniz bir Uygulama Ekran Görüntüsü Seti (App Screenshot Set) oluşturmak için bir POST isteği yürütmelidir. Bu set, belirli bir cihaz boyutu ve ekran türü için bir kapsayıcı (container) görevi görür. Bu kapsayıcı olmadan, bağımsız görüntü dosyalarının sunucuda barınacak bir yeri olmaz.

Ardından, o setin içinde bir Uygulama Ekran Görüntüsü rezervasyonu (App Screenshot reservation) oluşturmanız gerekir. Bu adım, Apple'a göndermek üzere olduğunuz görüntünün dosya boyutunu ve adını bildirir. API, asıl dosya aktarımı için belirli bir yükleme URL'si ve gerekli HTTP başlıklarıyla yanıt verecektir. Bu iki adımlı rezervasyon süreci Apple'a özgüdür ve genellikle ilk kez entegrasyon yapanların kafasını karıştırır.

Son olarak, betiğiniz sağlanan yükleme URL'sine ham ikili veriyi (raw binary data) içeren bir PUT isteği gerçekleştirir. Yükleme bittiğinde, App Store Connect API'sine son bir onay isteği göndermelisiniz. Bu, görüntüyü kaydeder ve Apple'ın dahili işlemlerini tetikler. Tam olarak bu diziyi otomatikleştirmek, sizi saatlerce sürecek manuel tıklamalardan kurtaran şeydir.

Dilleri API Uç Noktalarına Eşleme

Otomasyonun çok önemli bir parçası, doğru görüntünün doğru dil sekmesine gitmesini sağlamaktır. Apple, yerelleştirilmiş içeriği kategorize etmek için "en-US" veya "tr-TR" gibi özel yerel ayar kodları (locale codes) kullanır. Yerel dosya dizin yapınız, bu API yerel ayar kodlarıyla mükemmel bir şekilde eşleşmelidir. Klasör adlarınız ile Apple kodları arasındaki tutarsızlıklar, yükleme hattını bozacaktır.

Dahili dil isimlendirmenizi Apple standartlarına eşleyen bir yapılandırma (configuration) dosyası oluşturmak akıllıca bir uygulamadır. Betiğiniz, yükleme döngüsüne başlamadan önce bu yapılandırma dosyasını okuyabilir. Bu, dil kodlarını doğrudan otomasyon mantığınıza kodlamanızı (hardcoding) önler. Ayrıca gelecekte yeni diller eklemeyi basit bir yapılandırma güncellemesi haline getirir.

El yapımı eşleme çözümlerinden uzaklaşmak isteyen geliştiriciler için modern alternatifleri keşfedin. 2026'da Manuel App Store Ekran Görüntüsü Çevirisine 7 Alternatif (7 Alternatives to Manual App Store Screenshot Translation in 2026) hakkında bilgi edinin. Özel bir iş akışı oluşturmak başlangıçta çaba gerektirir, ancak sonraki her sürümde büyük kazanımlar sağlar. Artık dosyaları web konsolundaki 35 farklı dil sekmesine sürükleyip bırakmak zorunda değilsiniz.

Connect API Figma İş Akışlarını Entegre Etme

Özel bir betik oluşturmak harikadır, ancak tasarım aracınızı doğrudan mağazaya bağlamak daha da iyidir. Bir Connect API Figma entegrasyonu, görsel varlıklarınız ile geliştirici portalınız arasındaki boşluğu kapatır. Auto Localizer, tasarımcıların ve geliştiricilerin yapay zeka kullanarak App Store ekran görüntülerini 35'ten fazla dilde yerelleştirmesini ve tek bir tıklamayla doğrudan App Store Connect'e yüklemesini sağlayan bir Figma eklentisidir.

İşte bağımsız bir geliştirici için tam Auto Localizer iş akışı. İlk olarak, temel İngilizce ekran görüntülerinizi içeren Figma tasarım dosyanızı açın. İkinci olarak, eklentiyi çalıştırın ve App Store Connect kimlik bilgilerinizle birlikte OpenAI veya Gemini anahtarınızı girin. Üçüncü olarak, hedef dillerinizi seçin ve yerelleştir (localize) düğmesine basın.

Eklenti, metni kültürel farkındalıkla çevirir ve tüm varyantları anında doğrudan App Store Connect hesabınıza gönderir. Bu kesintisiz iş akışı, yerel sabit diskinize tek bir PNG bile dışa aktarmak zorunda kalmayacağınız anlamına gelir. Entegrasyon kendi anahtarlarınızı kullanır, bu da verilerinizin asla üçüncü taraf sunuculardan geçmediğini garanti eder.

Bir ekip işe almadan küresel olarak ölçeklenmek isteyen herkes için nihai zaman kurtarıcıdır. Bu ölçeklendirmenin etkisini anlamak için Yerelleştirme İle Uygulama İndirmeleri Nasıl Artırılır: 2026 Rehberi (How To Increase App Downloads With Localization: 2026 Guide) başlıklı yazıyı okuyun. Tasarımdan dağıtıma iş akışını kolaylaştırmak, bağımsız bir geliştiricinin kullanabileceği en büyük kaldıraçtır.

Güvenli API Entegrasyonu İçin En İyi Uygulamalar

Geliştirici kimlik bilgileriyle çalışırken güvenlik her zaman en büyük önceliğiniz olmalıdır. Özel anahtarınızı, Anahtar Kimliğinizi (Key ID) veya Veren Kimliğinizi (Issuer ID) asla doğrudan kaynak kodunuza kodlamayın (hardcode). Bu hassas değerleri çalışma zamanında (runtime) otomasyon betiklerinize enjekte etmek için ortam değişkenlerini (environment variables) kullanın. Bu uygulama, kodunuzu halka açık bir depoya (repository) gönderirseniz kazara sızıntıları önler.

Bir kimlik bilgisinin tehlikeye girmesi ihtimaline karşı riski en aza indirmek için anahtarlarınızı periyodik olarak değiştirin (rotate). App Store Connect portalı, eski bir anahtarı iptal etmeyi ve yenisini oluşturmayı kolaylaştırır. Yeni bir anahtar oluşturduktan hemen sonra ortam değişkenlerinizi veya CI/CD sırlarınızı (secrets) güncelleyin. Bu kimlik bilgilerine, üretim (production) veritabanı şifrelerinize gösterdiğiniz saygının aynısını gösterin.

Küresel uygulama pazarı performans raporlarına göre, mağaza varlıkları tamamen yerelleştirilmiş uygulamalar %26'ya kadar daha yüksek dönüşüm oranları (conversion rates) yaşıyor. Bu varlıkları sunan iş akışını korumak, büyümenizin kesintisiz kalmasını sağlar. Tüm güvenlik ve içerik temellerini kapsadığınızdan emin olmak için Dünyaya Açılmadan Önce 2026 App Store Yerelleştirme Kontrol Listesi'ni (2026 App Store Localization Checklist Before Going Global) inceleyin.

Lansman Sürecinizi Bugün Kolaylaştırın

API entegrasyonunda ustalaşmak, ürünleri küresel bir kitleye nasıl sunduğunuzu tamamen değiştirir. Gerekli kimlik bilgilerini güvenli bir şekilde nasıl oluşturacağınızı ve JWT kimlik doğrulamasını nasıl yöneteceğinizi öğrendiniz. Ekran görüntüsü yüklemelerinizi otomatikleştirmek ve hız sınırlarını yönetmek için gereken mimariyi anladınız. Ayrıca Figma'dan geliştirici portalına doğrudan nasıl köprü kuracağınızı da keşfettiniz.

Auto Localizer, bu karmaşık yükleme betiklerini kendiniz oluşturma ve sürdürme ihtiyacını ortadan kaldırır. Hem yapay zeka destekli çeviriyi hem de doğrudan API yüklemesini tek ve birleşik bir arayüzde gerçekleştirir. Sürüm döngünüzden saatlerce süren manuel emeği çıkarırken verilerinizin tam kontrolünü elinizde tutarsınız. Çok dilli bir uygulama varlığını yönetmenin en akıllıca yolu budur.

Back to all articles