Omówienie obsługi interfejsu API w usłudze Azure Static Web Apps
Aplikacje internetowe frontonu często wywołują interfejsy API zaplecza 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 zaplecza
/apijest dostępna dla aplikacji internetowej frontonu 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 | Korzystanie z własnych |
|---|---|---|
| Azure Functions | ✔ | ✔ |
| Azure API Management | ✔ | |
| Azure App Service | ✔ | |
| Azure Container Apps | ✔ |
- Zarządzane interfejsy API: domyślnie usługa Azure Static Web Apps automatycznie integruje się z usługą Azure Functions jako zapleczem interfejsu API. Interfejs API jest wdrażany przy użyciu statycznej aplikacji internetowej bez zarządzania oddzielnym zasobem usługi Azure Functions.
- Korzystanie z własnych interfejsów 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 z rolami.
- 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
/apitrasy, należy wdrożyć aplikację w statycznej aplikacji internetowej. - Nie można połączyć własnych zapleczy interfejsu API ze środowiskiem żądania ściągnięcia usługi Static Web Apps.