OpenAPI belirtimini içeri aktarma

UYGULANANLAR: Tüm API Management katmanları

Bu makalede, konumunda https://conferenceapi.azurewebsites.net?format=jsonbulunan bir "OpenAPI belirtimi" arka uç API'sini içeri aktarma işlemi gösterilmektedir. Bu arka uç API’si, Microsoft tarafından sağlanır ve Azure’da barındırılır. Makale, APIM API’sinin nasıl test edileceğini de göstermektedir.

Bu makalede şunları öğreneceksiniz:

• Azure portalını, Azure CLI'yi veya Azure PowerShell'i kullanarak OpenAPI belirtimini içeri aktarma
• Azure portalında API’yi test etme

Not

API içeri aktarma sınırlamaları, API içeri aktarma kısıtlamaları ve bilinen sorunlar bölümünde belgelenmiştir.

Önkoşullar

• Api Management örneği. Henüz bir örneğiniz yoksa şu hızlı başlangıcı tamamlayın: Azure API Management örneği oluşturma.

• Azure CLI

  • Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

    

  • CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

    • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

    • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

    • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

• Azure PowerShell

  • Azure PowerShell'i yerel olarak kullanmayı seçerseniz:
    • Az PowerShell modülünün en son sürümünü yükleyin.
    • Bağlan-AzAccount cmdlet'ini kullanarak Azure hesabınıza Bağlan.
  • Azure Cloud Shell'i kullanmayı seçerseniz:
    • Daha fazla bilgi için bkz . Azure Cloud Shell'e genel bakış.

Arka uç API'lerini içeri aktarma

Portal

1. Azure portalında API Management örneğine gidin.

2. Sol menüde API'ler>+ API Ekle'yi seçin.

3. Tanımdan oluştur'un altında OpenAPI'yi seçin.

   

4. API ayarlarını girin. Oluşturma sırasında değerleri ayarlayabilir veya daha sonra Ayarlar sekmesine giderek bunları yapılandırabilirsiniz. Ayarlar, İlk API'nizi içeri aktarma ve yayımlama öğreticisinde açıklanmıştır.

5. Oluştur'u belirleyin.

Azure CLI

Aşağıdaki örnek, belirtilen URL'den apim-hello-world adlı bir API Management örneğine openAPI belirtimini içeri aktarmak için az apim api import komutunu kullanır. URL yerine belirtim yolu kullanarak içeri aktarmak için parametresini --specification-path kullanın.

# API Management service-specific details
APIMServiceName="apim-hello-world"
ResourceGroupName="myResourceGroup"

# API-specific details
APIId="demo-conference-api"
APIPath="conference"
SpecificationFormat="OpenAPI"
SpecificationURL="https://conferenceapi.azurewebsites.net/?format=json"

# Import API
az apim api import --path $APIPath --resource-group $ResourceGroupName \
    --service-name $APIMServiceName --api-id $APIId \
    --specification-format $SpecificationFormat --specification-url $SpecificationURL

API'yi içeri aktardıktan sonra, gerekirse az apim api update komutunu kullanarak ayarları güncelleştirebilirsiniz .

PowerShell

Aşağıdaki örnek, belirtilen URL'den bir OpenAPI belirtimini apim-hello-world adlı bir API Management örneğine aktarmak için Import-AzApiManagementApi Azure PowerShell cmdlet'ini kullanır. URL yerine belirtim yolu kullanarak içeri aktarmak için parametresini -SpecificationPath kullanın.

# API Management service-specific details
$apimServiceName = "apim-hello-world"
$resourceGroupName = "myResourceGroup"

# API-specific details
$apiId = "demo-conference-api"
$apiPath = "conference"
$specificationFormat = "OpenAPI"
$specificationUrl = "https://conferenceapi.azurewebsites.net/?format=json"

# Get context of the API Management instance. 
$context = New-AzApiManagementContext -ResourceGroupName $resourceGroupName -ServiceName $apimServiceName

# Import API
Import-AzApiManagementApi -Context $context -ApiId $apiId -SpecificationFormat $specificationFormat -SpecificationUrl $specificationUrl -Path $apiPath

API'yi içeri aktardıktan sonra, gerekirse Set-AzApiManagementApi cmdlet'ini kullanarak ayarları güncelleştirebilirsiniz.

Portalda yeni API'yi test edin

İşlemler doğrudan portaldan çağrılabilir ve bu da yöneticilerin bir API'nin işlemlerini görüntülemesi ve test edebilmesi için kullanışlı bir yol sağlar.

1. Önceki adımda oluşturduğunuz API’yi seçin.

2. Test sekmesini seçin.

3. Bir işlem seçin. Sayfa, sorgu parametrelerinin ve üst bilgilerin alanlarını görüntüler.

   Not

   Test konsolunda API Management otomatik olarak bir Ocp-Apim-Subscription-Key üst bilgisini doldurur ve yerleşik tüm erişimli aboneliğin abonelik anahtarını yapılandırılır. Bu anahtar, API Management örneğindeki her API'ye erişim sağlar. İsteğe bağlı olarak HTTP İsteği'nin yanındaki "göz" simgesini seçerek Ocp-Apim-Subscription-Key üst bilgisini görüntüleyin.

4. İşleme bağlı olarak sorgu parametresi değerlerini, üst bilgi değerlerini veya istek gövdesini girin. Gönder'i seçin.

   Test başarılı olduğunda, arka uç başarılı bir HTTP yanıt kodu ve bazı verilerle yanıt verir.

   İpucu

   Varsayılan olarak, test konsolu API Management'ın CORS ara sunucusuna bir istek gönderir ve bu da isteği API Management örneğine iletir ve ardından arka uçta iletir. Bu proxy 13.91.254.72 genel IP adresini kullanır ve yalnızca genel uç noktalara ulaşabilir. Doğrudan tarayıcıdan API Management hizmetine istek göndermek istiyorsanız CORS proxy'sini atla'yı seçin. Test konsolunu kullanmak istediğinizde ve API Management ağ geçidiniz ağdan yalıtılmışsa veya CORS proxy'sinden gelen trafiğe izin vermiyorsa bu seçeneği kullanın.

API'de hata ayıklamak için bkz . Öğretici: İstek izleme kullanarak API'lerinizde hata ayıklama.

Diğer API'leri ekleme

Farklı hizmetler tarafından kullanıma sunulan API'lerden oluşan bir API oluşturabilirsiniz, örneğin:

• OpenAPI belirtimi
• SOAP API'si
• GraphQL API'si
• Azure Uygulaması Hizmetinde barındırılan bir Web Uygulaması
• Azure İşlev Uygulaması
• Azure Logic Apps
• Azure Service Fabric

Aşağıdaki adımları kullanarak mevcut API'nize farklı bir API ekleyin.

Not

Başka bir API'yi içeri aktardığınızda işlemler geçerli API'nize eklenir.

1. Azure portal'da Azure API Management kurulumunuza gidin.

   

2. Genel Bakış sayfasında veya soldaki menüden API'ler'i seçin.

   

3. Başka bir API eklemek istediğiniz API'nin yanındaki ... simgesine tıklayın.

4. Açılan menüden İçeri aktar'ı seçin.

   

5. API'nin içeri aktarılacağı hizmeti seçin.

   

İlgili konular

• API içeri aktarma sınırlamaları
• OpenAPI belirtimini içeri aktarma
• SOAP API’sini içeri aktarma
• SOAP API'sini içeri aktarma ve REST’e dönüştürme
• App Service API'sini içeri aktarma
• Kapsayıcı Uygulama API'sini içeri aktarma
• WebSocket API'lerini içeri aktarma
• GraphQL API’sini içeri aktarma
• GraphQL şemasını içeri aktarma ve alan çözümleyicilerini ayarlama
• Azure İşlev Uygulamalarını içeri aktarma
• Azure Mantıksal Uygulamalarını içeri aktarma
• Service Fabric hizmetlerini içeri aktarma
• Azure OpenAI API'lerini içeri aktarma
• OData API'sini içeri aktarma
• SAP OData meta verilerini içeri aktarma
• gRPC API'lerini içeri aktarma
• API’yi düzenleme

OpenAPI belirtimlerine göre doğrulama

OpenAPI belirtimindeki şemaya göre istekleri ve yanıtları (veya bunların öğelerini) doğrulamak için API Management doğrulama ilkelerini yapılandırabilirsiniz. Örneğin, istek veya yanıt gövdesinin boyutunu veya içeriğini doğrulamak için validate-content ilkesini kullanın.

Sonraki adımlar

• Ürün oluşturma ve yayımlama
• Yayımlanan API’yi dönüştürme ve koruma