Do czego służy usługa Azure API Center?
Centrum interfejsów API platformy Azure umożliwia śledzenie wszystkich interfejsów API w scentralizowanej lokalizacji na potrzeby odnajdywania, ponownego użycia i ładu. Centrum interfejsu API umożliwia opracowywanie i utrzymywanie ustrukturyzowanego i zorganizowanego spisu interfejsów API organizacji — niezależnie od typu, etapu cyklu życia lub lokalizacji wdrożenia — wraz z powiązanymi informacjami, takimi jak szczegóły wersji, pliki definicji interfejsu API i typowe metadane.
W centrum interfejsu API uczestnicy projektu w całej organizacji — w tym menedżerowie programów interfejsów API, administratorzy IT, deweloperzy aplikacji i deweloperzy interfejsów API — mogą odnajdywać, używać ich ponownie i zarządzać interfejsami API.
Uwaga
Centrum interfejsów API platformy Azure to rozwiązanie do zapewniania ładu interfejsu API w czasie projektowania i scentralizowanego odnajdywania interfejsów API. Platforma Azure oferuje również usługi uzupełniające, takie jak Azure API Management, rozwiązanie do zapewniania ładu interfejsu API środowiska uruchomieniowego i obserwowania przy użyciu bramy interfejsu API. Dowiedz się więcej o różnicach i sposobie współdziałania centrum interfejsów API platformy Azure i usługi API Management.
Świadczenia
Tworzenie i utrzymywanie spisu organizacyjnego — organizacje mogą utworzyć pełny spis interfejsów API dostępnych w organizacji. Zarejestruj interfejsy API zarządzane we wszystkich rozwiązaniach do zarządzania interfejsami API, w tym usługę Azure API Management i platformy od innych dostawców. Uwzględnij również niezarządzane interfejsy API i interfejsy API w ramach programowania. Wspieraj komunikację i pozwól menedżerom programów interfejsu API i deweloperom współpracować w celu zwiększenia ponownego użycia interfejsu API, jakości, zabezpieczeń, zgodności i produktywności deweloperów.
Zarządzanie interfejsami API organizacji — dzięki bardziej pełnemu wglądowi w tworzone i używane w organizacji interfejsy API menedżerowie programów interfejsów API i administratorzy IT mogą zarządzać tym spisem, aby zapewnić, że spełnia standardy organizacji, definiując niestandardowe metadane i analizując definicje interfejsu API w celu wymuszania zgodności z wytycznymi dotyczącymi stylu interfejsu API.
Łatwe odnajdywanie interfejsów API — organizacje chcą promować ponowne użycie interfejsu API w celu zmaksymalizowania produktywności deweloperów i zapewnienia, że deweloperzy korzystają z odpowiednich interfejsów API. Centrum interfejsów API platformy Azure ułatwia menedżerom programów i deweloperom odnajdywanie spisu i filtrowania interfejsu API przy użyciu wbudowanych i niestandardowych metadanych.
Przyspieszanie użycia interfejsu API — maksymalizuj produktywność deweloperów podczas korzystania z interfejsów API i upewnij się, że są one używane w bezpieczny sposób zgodny ze standardami organizacyjnymi.
Najważniejsze możliwości
Utwórz centrum interfejsu API i użyj go w następujących celach:
Zarządzanie spisem interfejsów API — deweloperzy interfejsów API i menedżerowie programów interfejsów API mogą rejestrować wszystkie interfejsy API organizacji w celu włączenia ich do scentralizowanego spisu przy użyciu witryny Azure Portal, interfejsu wiersza polecenia platformy Azure, narzędzi deweloperskich, takich jak potoki ciągłej integracji/ciągłego wdrażania oraz linki do źródeł interfejsu API, takich jak usługi Azure API Management.
Projektowanie i programowanie interfejsu API — za pomocą rozszerzenia Centrum interfejsu API platformy Azure dla programu Visual Studio Code deweloperzy mogą rejestrować interfejsy API bezpośrednio w tym samym środowisku projektowym, w którym tworzą swoje interfejsy API i aplikacje. Deweloperzy mogą korzystać z integracji rozszerzenia z usługami GitHub Copilot i GitHub Copilot dla platformy Azure, aby tworzyć definicje interfejsów API z opisów kodu lub języka naturalnego.
Reprezentacja interfejsu API w świecie rzeczywistym — dodawanie rzeczywistych informacji o poszczególnych interfejsach API, w tym wersjach i definicjach, takich jak definicje interfejsu OpenAPI. Wyświetlanie listy wdrożeń interfejsu API i kojarzenie ich ze środowiskami uruchomieniowymi, na przykład reprezentującymi usługę Azure API Management lub innymi rozwiązaniami do zarządzania interfejsami API.
Ład interfejsu API — organizowanie i filtrowanie interfejsów API oraz powiązanych zasobów przy użyciu wbudowanych i niestandardowych metadanych w celu ułatwienia ładu i odnajdywania interfejsów API przez użytkowników interfejsu API. Konfigurowanie lintingu i analizy w celu wymuszania jakości definicji interfejsu API.
Deweloperzy interfejsu API mogą przenosić kontrole zgodności projektu interfejsu API w lewo do programu Visual Studio Code ze zintegrowanym obsługą lintingu i wykrywaniem zmian powodujących niezgodność. Integracja z narzędziami, takimi jak serwer proxy deweloperów, w celu zapewnienia, że aplikacje nie korzystają z niezarejestrowanych interfejsów API w tle ani interfejsów API, które nie spełniają standardów organizacji.
Odnajdywanie i ponowne używanie interfejsu API — umożliwia deweloperom przedsiębiorstwa i menedżerom programów interfejsów API odnajdywanie interfejsów API za pośrednictwem portalu centrum interfejsu API lub katalogu platformy interfejsu API, do którego uzyskuje się dostęp przy użyciu rozszerzenia programu Visual Studio Code centrum interfejsów API platformy Azure.
Aby uzyskać więcej informacji na temat jednostek, którymi można zarządzać, i możliwości w centrum interfejsów API platformy Azure, zobacz Kluczowe pojęcia.
Dostępne regiony
Centrum interfejsów API platformy Azure jest obecnie dostępne w następujących regionach świadczenia usługi Azure:
- Australia Wschodnia
- Indie Środkowe
- East US
- Południowe Zjednoczone Królestwo
- West Europe
Centrum interfejsów API jest oferowane w ramach planu bezpłatnego i planu w warstwie Standardowa. Dowiedz się więcej.
Centrum interfejsów API platformy Azure i ekosystem interfejsu API
Centrum interfejsów API platformy Azure może pełnić kluczową rolę w ekosystemie interfejsu API organizacji. Rozważmy hipotetyczną organizację firmy Contoso, która przyjęła strategię typu "pierwszy interfejs API", podkreślając znaczenie interfejsów API w zakresie tworzenia i integracji oprogramowania.
Deweloperzy interfejsów API firmy Contoso, deweloperzy aplikacji, menedżerowie programów interfejsu API i menedżerowie interfejsów API współpracują za pośrednictwem Centrum interfejsów API platformy Azure, aby opracowywać i używać spisu interfejsów API organizacji. Zapoznaj się z poniższym diagramem i wyjaśnieniem.
Ekosystem interfejsu API firmy Contoso obejmuje następujące elementy:
Programowanie interfejsu API — deweloperzy firmy Contoso regularnie tworzą ASP.NET internetowych interfejsów API. Tworzą również usługę Azure Functions z wyzwalaczami HTTP.
Środowiska wdrażania interfejsu API — firma Contoso wdraża część swoich interfejsów API w usłudze aplikacja systemu Azure Service. Inny podzbiór ich interfejsów API jest wdrażany w aplikacji funkcji platformy Azure.
Azure API Management — firma Contoso używa usługi Azure API Management do zarządzania, publikowania i zabezpieczania swoich interfejsów API. Używają oddzielnych wystąpień do tworzenia, testowania i produkcji, z których każda ma odrębną nazwę.
Centrum interfejsów API platformy Azure — firma Contoso przyjęła centrum interfejsu API platformy Azure jako scentralizowane centrum odnajdywania, zapewniania ładu i zużycia interfejsów API. Centrum interfejsów API służy jako centrum ustrukturyzowanego i zorganizowanego interfejsu API, które udostępnia kompleksowe informacje o wszystkich interfejsach API organizacji, zachowując powiązane informacje, w tym wersje i skojarzone wdrożenia.