API içeri aktarma kısıtlamaları ve bilinen sorunlarAPI import restrictions and known issues

Bu liste hakkındaAbout this list

API içeri aktarılırken arasında bazı kısıtlamalar gelen veya başarıyla içeri aktarmadan önce düzeltilmesi gereken sorunları belirlemek.When importing an API, you might come across some restrictions or identify issues that need to be rectified before you can successfully import. Bu makalede belgeleri bunlar düzenlenmiş tarafından API içeri aktarma biçimi.This article documents these, organized by the import format of the API.

Openapı/Swagger OpenAPI/Swagger

Openapı belgenizi alma hataları almaya önceden doğruladınız emin olun.If you're receiving errors importing your OpenAPI document, make sure you've validated it beforehand. Her iki Tasarımcı (Tasarım - ön uç - Openapı belirtimi Düzenleyicisi) Azure portalında veya üçüncü taraf aracı gibi kullanarak bunu yapabilirsiniz Swagger Editor.You can do that either using the designer in the Azure portal (Design - Front End - OpenAPI Specification Editor), or with a third-party tool such as Swagger Editor.

Genel General

  • Gerekli parametreleri yolu hem de sorgu genelinde benzersiz adlara sahip olmalıdır.Required parameters across both path and query must have unique names. (Openapı bir parametre adı yalnızca içinde örneğin yol, sorgu, üst bilgisi bir konumu benzersiz olması gerekir.(In OpenAPI a parameter name only needs to be unique within a location, for example path, query, header. Ancak, API Yönetimi'nde (Bu, Openapı desteklemeyen) yolu hem de sorgu parametreleri tarafından ayrılmış işlemleri izin veriyoruz.However, in API Management we allow operations to be discriminated by both path and query parameters (which OpenAPI doesn't support). That's neden parametre adları tüm URL şablonu içinde benzersiz olması zorunlu kılarız.)That's why we require parameter names to be unique within the entire URL template.)
  • $ref işaretçileri, harici dosyalara başvuruda bulunamaz.$ref pointers can't reference external files.
  • x-ms-yolları ve x sunucuları uzantıları yalnızca desteklenir.x-ms-paths and x-servers are the only supported extensions.
  • Özel uzantılar içeri aktarma işlemi sırasında yok sayılır ve olmayan kaydedilmiş veya de dışarı aktarma için korunur.Custom extensions are ignored on import and aren't saved or preserved for export.
  • Özyineleme -API Management, tanımlanan tanımları yinelemeli olarak (örneğin, kendilerini kaynağa başvuran şemaları) desteklemez.Recursion - API Management doesn't support definitions defined recursively (for example, schemas referring to themselves).
  • Kaynak dosya URL'si (varsa) için göreli sunucu URL'leri uygulanır.Source file URL (if available) is applied to relative server URLs.

Openapı sürüm 2 OpenAPI version 2

  • Yalnızca JSON biçimi desteklenmiyor.Only JSON format is supported.

Openapı sürüm 3 OpenAPI version 3

  • Çok sayıda varsa sunucuları belirtilirse, API Management, ilk HTTPs URL'sini seçmek çalışır.If many servers are specified, API Management will try to select the first HTTPs URL. -İlk HTTP URL'si HTTPs URL'leri değilseniz.If there aren't any HTTPs URLs - the first HTTP URL. HTTP URL'leri - değilse sunucu URL'si boş olur.If there aren't any HTTP URLs - the server URL will be empty.
  • Örnekler desteklenmez, ancak örnek olduğu.Examples isn't supported, but example is.
  • Multipart/form-data desteklenmiyor.Multipart/form-data isn't supported.

Önemli

OpenAPI içeri aktarma ile ilgili önemli bilgiler ve ipuçları için bu belgeye bakın.See this document for important information and tips related to OpenAPI import.

WSDL WSDL

WSDL dosyaları, SOAP doğrudan API'ları oluşturmak veya bir SOAP ve REST API arka uç olarak sunmak için kullanılır.WSDL files are used to generate SOAP Pass-through APIs or serve as the backend of a SOAP-to-REST API.

  • SOAP bağlamaları -style "belgesi" ve "değişmez" kodlama yalnızca SOAP bağlamaları desteklenir.SOAP bindings -Only SOAP bindings of style ”document” and “literal” encoding are supported. "Rpc" stil veya SOAP kodlamasına için desteği yoktur.There is no support for “rpc” style or SOAP-Encoding.
  • WSDL: import -bu özniteliği desteklenmiyor.WSDL:Import - This attribute isn't supported. Müşteriler, bir belgeye Imports birleştirmeniz gerekir.Customers should merge the imports into one document.
  • Birden çok bölümü olan iletiler -bu tür iletileri desteklenmez.Messages with multiple parts - These types of messages aren't supported.
  • WCF wsHttpBinding -Windows Communication Foundation ile oluşturulan SOAP Hizmetleri basicHttpBinding kullanması gereken - wsHttpBinding desteklenmez.WCF wsHttpBinding - SOAP services created with Windows Communication Foundation should use basicHttpBinding - wsHttpBinding isn't supported.
  • MTOM - MTOM kullanan hizmetler olabilir çalışır.MTOM - Services using MTOM may work. Resmi destek şu anda sunulan değil.Official support isn't offered at this time.
  • Özyineleme -türlere yinelemeli olarak tanımlanan (örneğin, bir dizi kendileri için bakın) APIM tarafından desteklenmez.Recursion - Types that are defined recursively (for example, refer to an array of themselves) are not supported by APIM.
  • Birden çok ad - birden çok ad şemada kullanılabilir, ancak yalnızca hedef ad alanı, ileti bölümlerini tanımlamak için kullanılabilir.Multiple Namespaces - Multiple namespaces can be used in a schema, but only the target namespace can be used to define message parts. Giriş veya çıkış diğer öğeleri tanımlamak için kullanılan ad alanları hedefinden korunmaz.Namespaces other than the target which are used to define other input or output elements are not preserved. Böyle bir WSDL belgesi aktarılabilen olsa da, dışarı aktarma üzerinde tüm ileti bölümleri WSDL hedef ad alanı olacaktır.Although such a WSDL document can be imported, on export all message parts will have the target namespace of the WSDL.

WADL WADL

Şu anda bilinen WADL alma herhangi bir sorun vardır.Currently, there are no known WADL import issues.