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ługę API Management, rozwiązanie do zapewniania ładu interfejsu API środowiska uruchomieniowego i możliwości obserwowania przy użyciu bramy interfejsu API. Dowiedz się więcej o różnicy.

Świadczenia

  • Tworzenie i utrzymywanie spisu organizacyjnego — organizacje mogą utworzyć pełny spis interfejsów API dostępnych w organizacji. 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 — zarejestruj wszystkie interfejsy API organizacji w celu włączenia ich do scentralizowanego spisu.

  • 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.

  • Odnajdywanie i ponowne używanie interfejsu API — umożliwia deweloperom i menedżerom programów interfejsów API odnajdywanie interfejsów API za pośrednictwem witryny Azure Portal, portalu centrum interfejsu API i narzędzi deweloperskich, w tym rozszerzenia programu Visual Studio Code zintegrowanego z usługą GitHub Copilot.

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 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.

Diagram przedstawiający centrum interfejsu API w przykładowym ekosystemie interfejsu API.

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ę: APIM-DEV, APIM-TEST i APIM-PROD.

  • 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.

Następne kroki