Azure Static Web Apps 中的 API 支援概觀
前端 Web 應用程式通常會針對資料和服務呼叫後端 API。 Azure Static Web Apps 可透過與 Azure 服務整合來提供內建的無伺服器 API 端點。
Azure Static Web Apps API 的主要功能包括：
整合式安全性 ，可直接存取使用者 驗證和角色型授權 資料。
無縫路由 ，讓
/api路由可供前端 Web 應用程式使用，而不需要自訂 CORS 規則。
API 選項
下列 Azure 服務可以與 Azure Static Web Apps 整合：
| 服務 | 受管理的 | 攜帶您自己的 |
|---|---|---|
| Azure Functions | ✔ | ✔ |
| Azure API 管理 | ✔ | |
| Azure App Service | ✔ | |
| Azure 容器應用程式 | ✔ |
- 受控 API ：根據預設，Azure Static Web Apps 會自動與 Azure Functions 整合為 API 後端。 您可以使用靜態 Web 應用程式部署 API，而不需管理個別的 Azure Functions 資源。
- 攜帶您自己的 API ：您可以將靜態 Web 應用程式與裝載在 Azure Functions、API 管理、App Service 或 Container Apps 中的現有 API 整合。 您可以自行管理及部署 API 資源。
注意
自備 API 僅適用于 Azure Static Web Apps Standard 方案。 所有 Azure Static Web Apps 方案中都有內建的受控 Azure Functions API。
API 條件約束
下列條件約束適用于所有 API 後端：
- 每個靜態 Web 應用程式環境一次只能設定一種後端 API。
- API 路由前置詞必須是
/api。 - API 的路由規則僅支援 使用角色 的重新導向 和保護 路由。
- API 僅支援 HTTP 要求。 例如，不支援 WebSocket。
- 每個 API 要求的最大持續時間為 45 秒。
- 不支援網路隔離後端。
下列條件約束適用于自備 API 後端：
- 必須先將應用程式部署到靜態 Web 應用程式，
/api才能解析路由的要求。 - 自備 API 後端無法連結至靜態 Web Apps 提取要求環境。