Aracılığıyla paylaş

App Center API Belgeleri

Önemli

Visual Studio App Center, 30 Haziran 2026'ya kadar desteklenmeye devam edecek Analiz ve Tanılama özellikleri dışında 31 Mart 2025'te kullanımdan kaldırılmıştır. Daha fazla bilgi edinin.

App Center OpenAPI Spesifikasyonu (Swagger)

App Center bir dizi API uç noktasını kullanıma sunar. App Center API'sini App Center OpenAPI Belirtimi aracılığıyla keşfedebilirsiniz.

App Center OpenAPI belirtimi, API belirtecinizi kullanarak kimlik doğrulaması yapmanıza olanak tanır. Kimliğiniz doğrulandıktan sonra API hakkında bilgi edinmek ve hangi verileri döndürdüğüne bakmak için App Center API'lerini çağırabilirsiniz.

Belirteç türleri: kullanıcı belirteçleri ve uygulama belirteçleri

App Center iki tür API belirteci sunar: kullanıcı belirteçleri ve uygulama belirteçleri.

Kullanıcı API'leri belirteçleri, App Center kullanıcısı ile aynı haklara sahiptir. Kullanıcı API'leri belirteçleri, ilişkili olduğunuz tüm kuruluşlarda ve uygulamalarda çalışır.

Uygulama API'si belirteçleri Yalnızca bir uygulama içinde Yönetici veya Görüntüleyici haklarına sahiptir.

Her App Center hesabı en fazla 5000 API belirteci oluşturabilir.

Tavsiye

Yetkilendirme kapsamını bir kerede yalnızca bir uygulamayla sınırlamak için Uygulama API'leri belirteçleri oluşturmanızı ve kullanmanızı öneririz (ve bir belirtecin kullanıma sunulduğunda riski sınırlayın). Kuruluşlarla veya paylaşılan dağıtım gruplarıyla çalışma gibi tek bir uygulamanın ötesinde bir şeyi otomatikleştirmeniz gerekiyorsa, bir Kullanıcı API belirteci oluşturmanız gerekir.

Uyarı

API belirteçlerini kaynak koduna eklemeyin. API belirteçleri gizli dizi olarak ele alınmalı ve güvenli bir şekilde depolanmalıdır.

Uyarı

POST/PUT/PATCH API çağrıları için bir istek yük gövdesi içermelidir. Boş bir yük gövdesi için {} kullanın, aksi takdirde API çağrıları 411 uzunluk gerekli hata yanıtı alır.

App Center API anahtarı oluşturma

  1. https://appcenter.ms Adresine gidin ve hesap kimlik bilgilerinizi kullanarak oturum açın.

  2. API belirteci oluşturmak istediğiniz uygulamayı seçin.

  3. Sol tarafta Ayarlar'ı seçin.

  4. Orta panelde, menü listesinden Uygulama API Belirteçleri'ni seçin.

  5. Sağ üst köşede Yeni API belirteci'ne tıklayın.

  6. Metin alanına belirteciniz için açıklayıcı bir ad girin.

  7. Uygulama API belirteciniz için erişim türünü seçin:

    Tam Erişim: Tam erişimli Bir Uygulama API'sinin belirteci, bu uygulama için Yönetici izinlerinin eşdeğeridir. Yalnızca Yöneticiler tam erişimli Uygulama API'si belirteçleri oluşturabilir.

    Yalnızca Okunur: Yalnızca okuma yetkisine sahip bir Uygulama API belirteci, o uygulama için Görüntüleyici erişim izinlerine eşdeğerdir. Yöneticiler ve Geliştiriciler salt okunur Uygulama API'leri belirteçleri oluşturabilir.

  8. Panelin en altında Yeni API belirteci ekle'ye tıklayın.

  9. Uygulama API belirteciniz ile bir açılır pencere görüntülenecek. Daha sonra kullanmak üzere kopyalayıp güvenli bir konumda depolayın. Güvenlik nedeniyle Kapat düğmesine tıkladıktan sonra aynı belirteci yeniden göremez veya oluşturamazsınız.

  10. Kapat düğmesine tıklayın.

App Center Kullanıcı API Belirteci Oluşturma

  1. https://appcenter.ms Adresine gidin ve hesap kimlik bilgilerinizi kullanarak oturum açın.

  2. App Center portalının sağ üst köşesinde hesap avatarınıza tıklayın ve Hesap Ayarları'nı seçin.

  3. Orta panelde, menü listesinden Kullanıcı API'leri Belirteçleri'ni seçin.

  4. Sağ üst köşede Yeni API belirteci'ne tıklayın.

  5. Metin alanına belirteciniz için açıklayıcı bir ad girin.

  6. Kullanıcı API belirteciniz için erişim türünü seçin:

    Tam Erişim: Tam erişim kullanıcı API'sinin belirteci, geçerli hesap / kuruluş için sahip olduğunuz tüm izinlere sahiptir. Örneğin, bir uygulama için yönetici veya geliştirici izinleriniz yoksa, tam erişim kullanıcı API'si belirteci kullanıyor olsanız bile kullanıcı test çalıştıramaz.

    Salt Okunabilir: Salt okunabilir bir Kullanıcı API anahtarı, geçerli hesap/kuruluş için Görüntüleyici erişim iznine sahiptir. Örneğin, salt okunur bir Kullanıcı API'si belirteci ile kilitlenmelerden, analizlerden verileri okuyabilir ve temel uygulama bilgilerini alabilirsiniz. Salt okunur kullanıcı API jetonları uygulama ayarlarını değiştiremez, ihracat yapılandırması oluşturamaz vb.

  7. Panelin en altında Yeni API belirteci ekle'ye tıklayın.

  8. Kullanıcı API belirtecinizin göründüğü bir açılır pencere açılacaktır. Daha sonra kullanmak üzere kopyalayıp güvenli bir konumda depolayın. Güvenlik nedeniyle Kapat düğmesine tıkladıktan sonra aynı belirteci yeniden göremez veya oluşturamazsınız.

  9. Kapat düğmesine tıklayın.

API isteğinde API Belirteci kullanma

Uygulamadan App Center'a API istekleri gönderirken, App Center'a gönderilen her isteğin üst bilgisine API belirtecini eklemeniz gerekir.

İsteğin X-API-Token üst bilgi özelliğinde API belirtecini geçirin.

App Center uygulama adınızı ve sahip adınızı bulma

App Center'ın API işlevlerinden ve CLI isteklerinden bazıları, parametre olarak bir uygulama adı veya sahip adı gerektirir.

Örneğin, kullanıcıyı uygulamadan kaldırmaya yönelik API çağrısı her ikisini de gerektirir: DELETE /v0.1/apps/{owner_name}/{app_name}/users/{user_email}.

Uygulama adını ve sahip adını bir App Center URL'sinden veya App Center CLI kullanarak bulabilirsiniz.

App Center URL'sinden owner_name ve app_name bul

  1. https://appcenter.ms'a gidin.
  2. Uygulamanıza gidin.
  3. Uygulamanızın URL'sine baktığınızda biçimindedir https://appcenter.ms/users/{owner-name}/apps/{app-name}.

Sahip bir kullanıcı veya kuruluş olabilir. Örneğin:

Sahibi URL Sahip adı Uygulama adı
Kullanıcı https://appcenter.ms/users/AlexLerxst/apps/Caravan-01 AlexLerxst Karavan-01
Kuruluş https://appcenter.ms/orgs/BallardFlowers/apps/BouquetOrders-app BallardFlowers BuketSiparişler-Uygulaması

Owner_name ve app_name'i App Center CLI'dan bulun.

App Center CLI'yı henüz yüklemediyseniz, yükleme ve kullanım yönergeleriNi App Center CLI belgelerinde bulabilirsiniz.

Yüklendikten sonra aşağıdakini çalıştırarak erişiminiz olan uygulamaların listesini alın:

appcenter apps list

App Center CLI, biçiminde {owner-name}/{app-name}bir uygulama listesi görüntüler.

Komut satırı işlevlerinin tam listesi için App Center CLI belgelerine bakın .

App Center OpenAPI Belirtimi ile API Belirteci Kullanma

App Center OpenAPI Belirtimi API kimlik doğrulamasını sizin yerinize işler, bu nedenle istekleriniz için API belirtecini üst bilgiler içine yapıştırmanız gerekmez. App Center API'lerini API belirtecinizle test etmek için:

  1. API'lerimizi keşfetmek için App Center'ın OpenAPI belirtimine gidin.

  2. Sağ üst köşedeki Yetki ver düğmesine tıklayın.

  3. APIToken bölümünün altında, API belirtecini Değer'e yapıştırın ve Yetki ver'e tıklayın.

    App Center kullanımını yetkilendirmek için API belirtecini ayarlama

  4. "Yetkili" ve Oturum Kapatma düğmesi görünüyorsa yetkilendirme başarılı oldu. Açılır penceredeki sağ üst köşedeki "X" işaretine tıklayarak açılır menüden çıkın.

OpenAPI (Swagger) kullanarak ilk API çağrınızı yapma

Bu bölümde, API çağrısını kullanarak App Center'ın GET /v0.1/user nasıl kullanacağınız gösterilir. Bu API çağrısı kullanıcının profil verilerini döndürür.

  1. Yukarıdaki yönergeleri izleyerek bir API belirteci oluşturun.
  2. Önceki bölümde yer alan yönergeleri izleyerek OpenAPI Belirtimi sayfasını API belirtecinizi kullanacak şekilde yetkilendirin.
  3. Hesap'ın altında öğesine GET /v0.1/usertıklayın.
  4. Sol köşedeki Deneyin düğmesine tıklayın.
  5. Parametreler bölümünün altındaki Yürüt düğmesine tıklayın.
  6. Harika! Yanıtı artık Yanıtlar bölümünün altında görebilirsiniz.

API Belirtecini iptal etme

Bir API belirtecinin sızdırılması durumunda, App Center hesabınıza yetkisiz erişimi önlemek için hemen iptal etmelisiniz.

Kullanıcı API belirtecini iptal etme

  1. https://appcenter.ms'a gidin.
  2. App Center portalının sağ üst köşesinde hesap avatarınıza tıklayın ve Hesap Ayarları'nı seçin.
  3. Orta panelde, menüden Kullanıcı API'leri Belirteçleri'ni seçin.
  4. İptal etmek istediğiniz belirtecin yanındaki kutuyu işaretleyin ve sağ üst köşedeki Sil düğmesine tıklayın.

Uygulama API belirtecini iptal etme

  1. https://appcenter.ms'a gidin.
  2. API belirtecini iptal etmek istediğiniz uygulamayı seçin.
  3. Sol tarafta Ayarlar'ı seçin.
  4. Orta panelde menüden Uygulama API Belirteçleri'ni seçin.
  5. İptal etmek istediğiniz belirtecin yanındaki kutuyu işaretleyin ve sağ üst köşedeki Sil düğmesine tıklayın.
  • Last updated on