Environments
Gateway Environments
Generated runtime and ingestion contracts use /sdac/... source routes. Some
APIM products publish /ai/sdac/... aliases for direct gateway clients; verify
the target APIM publication before using that prefix.
| Environment | Base URL | OAuth Scope | Network |
|---|---|---|---|
| Development | https://dev-sdac-aitools-wkhc-apim.azure-api.net | Use the SDAC dev scope value from the issued credentials | VNet + Service Endpoints |
| Staging | https://sdac-api-staging.azure-api.net | api://sdac-api-staging/.default | VNet + Private Endpoints |
| Production | https://sdac-api-prod.azure-api.net | api://sdac-api/.default | VNet + Private Endpoints |
When examples use an APIM alias, treat /ai/sdac/... as the published gateway
prefix and /sdac/... as the source/runtime route.
Surface Prefixes
| Surface | Prefix | Notes |
|---|---|---|
| Direct gateway API | /ai/sdac/... when published | APIM alias with gateway auth; source route remains /sdac/... |
| Widget same-origin ingestion proxy | /api/ingestion/sdac/... | Browser-facing widget chat, feedback, validation, session, and report-info routes |
| Widget same-origin Mastra proxy | /api/mastra/sdac/... | Browser-facing widget workbook upload and analysis-status routes |
| Mastra runtime / ingestion service | /sdac/... | Upstream service paths behind APIM or widget server proxies |
Health and Readiness
Operational checks are deployment-facing rather than part of the gateway business API.
| Endpoint | Surface | Purpose |
|---|---|---|
GET /health | Ingestion service | Basic liveness check |
GET /ready | Ingestion service | Dependency readiness check |
GET /api/health | Widget server | Widget liveness check |
If a deployment is unavailable, direct callers should expect gateway 5xx responses, and widget callers should expect proxy failures such as 502.