Omówienie obsługi interfejsu API w usłudze Azure Static Web Apps

Aplikacje internetowe frontendowe często wywołują API backendowe dla danych i usług. Usługa Azure Static Web Apps zapewnia wbudowane punkty końcowe bezserwerowych interfejsów API za pośrednictwem integracji z usługami platformy Azure.

Najważniejsze funkcje interfejsów API usługi Azure Static Web Apps obejmują:

  • Zintegrowane zabezpieczenia z bezpośrednim dostępem do uwierzytelniania użytkowników i danych autoryzacji opartych na rolach.

  • Bezproblemowy routing, który sprawia, że trasa back-endu /api jest dostępna dla front-endowej aplikacji internetowej bez konieczności używania niestandardowych reguł CORS.

Opcje interfejsu API

Następujące usługi platformy Azure można zintegrować z usługą Azure Static Web Apps:

Usługa Zarządzana Przynieś swoje
Azure Functions
Azure API Management
Azure App Service
Azure Container Apps
  • API zarządzane: Domyślnie usługa Azure Static Web Apps automatycznie integruje się z Azure Functions jako zaplecze API. Interfejs API jest wdrażany przy użyciu statycznej aplikacji internetowej bez zarządzania oddzielnym zasobem usługi Azure Functions.
  • Dostarcz własne interfejsy API: Możesz zintegrować statyczną aplikację internetową z istniejącymi interfejsami API hostowanymi w usługach Azure Functions, API Management, App Service lub Container Apps. Zarządzasz zasobami interfejsu API i wdrażasz je samodzielnie.

Uwaga

Korzystanie z własnych interfejsów API jest dostępne tylko w planie Usługi Azure Static Web Apps w warstwie Standardowa. Wbudowane, zarządzane interfejsy API usługi Azure Functions są dostępne we wszystkich planach usługi Azure Static Web Apps.

Ograniczenia interfejsu API

Następujące ograniczenia dotyczą wszystkich zapleczy interfejsu API:

  • Każde statyczne środowisko aplikacji internetowej można skonfigurować tylko przy użyciu jednego typu interfejsu API zaplecza jednocześnie.
  • Prefiks trasy interfejsu API musi mieć wartość /api.
  • Reguły tras dla interfejsów API obsługują tylko przekierowania i zabezpieczanie tras przy użyciu ról.
  • Tylko żądania HTTP są obsługiwane w przypadku interfejsów API. Na przykład usługa WebSocket nie jest obsługiwana.
  • Maksymalny czas trwania każdego żądania interfejsu API 45 sekund.
  • Izolowane zaplecza sieci nie są obsługiwane.

Następujące ograniczenia dotyczą zapleczy interfejsu API Bring your own:

  • Aby można było rozpoznać żądania dotyczące /api trasy, aplikacja musi zostać wdrożona w statycznej aplikacji sieciowej.
  • Nie można połączyć własnych zapleczy interfejsu API ze środowiskiem żądania ściągnięcia usługi Static Web Apps.

Następne kroki