Vue d’ensemble de la prise en charge des API dans Azure Static Web Apps
Les applications web frontales appellent souvent des API principales pour les données et les services. Azure Static Web Apps fournit des points de terminaison d’API serverless intégrés via des services Azure.
Les principales fonctionnalités des API Azure Static Web Apps sont les suivantes :
Sécurité intégrée avec accès direct aux données d’authentification et d’autorisation basées sur les rôles.
Routage transparent qui met l’itinéraire
/apide back-end à la disposition de l’application web front-end sans nécessiter de règles CORS personnalisées.
Options d’API
Les services Azure suivants peuvent être intégrés à Azure Static Web Apps :
| Service | Gérée | Apporter votre propre |
|---|---|---|
| Azure Functions | ✔ | ✔ |
| Gestion des API Azure | ✔ | |
| Azure App Service | ✔ | |
| Azure Container Apps | ✔ |
- API managées : par défaut, Azure Static Web Apps s’intègre automatiquement à Azure Functions en tant que back-end d’API. Vous déployez une API avec votre application web statique sans gérer une ressource Azure Functions distincte.
- Apporter vos propres API : vous pouvez intégrer votre application web statique à des API existantes hébergées dans Azure Functions, Gestion des API, App Service ou Container Apps. Vous gérez et déployez les ressources d’API vous-même.
Remarque
« Apporter vos propres API » n’est disponible que dans le plan Standard d’Azure Static Web Apps. Les API d’Azure Functions managées intégrées sont disponibles dans tous les plans Azure Static Web Apps.
Contraintes d’API
Les contraintes suivantes s’appliquent à tous les back-ends d’API :
- Chaque environnement d’application web statique ne peut être configuré qu’avec un seul type d’API back-end à la fois.
- Le préfixe d’itinéraire d’API doit être
/api. - Les règles d’itinéraire des fonctions d’API prennent uniquement en charge les redirections et les itinéraires de sécurisation avec des rôles.
- Seules les requêtes HTTP sont prises en charge pour les API. WebSocket, par exemple, n’est pas pris en charge.
- Durée maximale de chaque requête d’API de 45 secondes.
- Les back-ends isolés du réseau ne sont pas pris en charge.
Les contraintes suivantes s’appliquent aux back-ends « Apporter vos propres API » :
- Une application doit être déployée sur votre application web statique avant que les demandes adressées à la route
/apipuissent être résolues. - Vous ne pouvez pas lier les back-ends « Apporter vos propres API » à un environnement de demande de tirage Static Web Apps.