# Tryb zgodności bramy API

API Contracts oferuje tryb zgodności z bramą API, aby ułatwić zaimportowanie definicji do AWS API Gateway i Azure API Management.

Podczas eksportowania API w trybie zgodności z bramą API Contracts może zmodyfikować Twoją definicję, aby można ją było pomyślnie zaimportować do wybranej bramy.

W niektórych przypadkach nie ma żadnych modyfikacji, ale wyświetlany jest komunikat informujący o problemie ze zgodnością, który może wystąpić w przypadku wyeksportowanej definicji.

## Eksportowanie definicji OAS 3.0 dla AWS API Gateway

W poniższej tabeli opisano, w jaki sposób API Contracts obsługuje funkcje nieobsługiwane przez AWS API Gateway podczas eksportowania definicji oraz co dzieje się w AWS API Gateway podczas importowania definicji.

| Nieobsługiwana cecha OpenAPI | Kontrakty API<br>zachowanie podczas operacji eksportować | Zachowanie AWS API Gateway podczas importu |
| --- | --- | --- |
| Atrybut example nie jest<br>obsługiwany. | Atrybut zostaje zachowany. | Atrybut zostaje usunięty ze schematu. |
| Atrybut readOnly nie jest<br>obsługiwany. | Atrybut zostaje zachowany. | Atrybut zostaje usunięty ze schematu. |
| Atrybut additionalProperties<br>nie jest obsługiwany. | Atrybut zostaje zachowany i wyświetlany jest<br>komunikat informacyjny. | Wyświetlany jest komunikat ostrzegawczy, ale można go zignorować, a definicję można<br>pomyślnie zaimportować. |
| Typy definicji zabezpieczeń:<br><br><ul><li><span>oauth2</span> nie jest obsługiwany,</li><li><span>http</span> nie jest obsługiwany,</li><li><span>openIdConnect</span> nie jest obsługiwane.</li></ul> | Schematy zabezpieczeń zostają zachowane i wyświetlany jest<br>komunikat informacyjny. | Wyświetlany jest komunikat ostrzegawczy, ale można go zignorować, a definicję można<br>pomyślnie zaimportować. |
| Proste typy danych w odpowiedziach nie są obsługiwane. | Typ prosty jest opakowywany w schemat komponentu i wyświetlany jest<br>komunikat ostrzegawczy. | Import kończy się powodzeniem. |
| Zakresy typów mediów nie są obsługiwane. | Żądanie lub odpowiedź zostaje zachowana i wyświetlany jest komunikat informacyjny. | Import kończy się niepowodzeniem i wyświetla się komunikat ostrzegawczy. |
| Domyślna odpowiedź nie jest obsługiwana. | Odpowiedź zostaje zachowana i wyświetlany jest komunikat informacyjny. | Import kończy się niepowodzeniem i wyświetla się komunikat ostrzegawczy. |
| Odpowiedzi zakresowe nie są obsługiwane. | Odpowiedź zostaje zachowana i wyświetlany jest komunikat informacyjny. | Import kończy się niepowodzeniem i wyświetla się komunikat ostrzegawczy. |
| Zmienne ścieżki, parametry zapytania i nagłówki muszą mieć unikalne nazwy. | Parametry zostają zachowane i wyświetlany jest komunikat o błędzie. | Importowanie kończy się niepowodzeniem. |

## Eksportowanie definicji OAS/Swagger 2.0 dla usługi Azure API Management

W poniższej tabeli opisano, jak API Contracts obsługuje funkcje nieobsługiwane przez Azure API Management podczas eksportowania definicji oraz co dzieje się w Azure API Management podczas importowania definicji.

| Nieobsługiwana cecha OpenAPI | Kontrakty API<br>zachowanie podczas operacji eksportować | Zachowanie usługi Azure API Management podczas importu |
| --- | --- | --- |
| Wymagane parametry zarówno w ścieżkach, jak i w zapytaniach muszą mieć unikalne<br>nazwy. | Wyświetlany jest komunikat o błędzie. | Importowanie kończy się niepowodzeniem. |