SCAPI enforces timeout thresholds and size limits to ensure optimal performance and system stability.
Default Timeouts
note: Some API families, such as SLAS and Omnichannel Inventory (OCI), do not have gateway timeouts.
| Type | Timeout | HTTP status code if exceeded | Customizable |
|---|---|---|---|
| API Client → SCAPI Gateway | |||
| Connection Idle | 400s | - | No |
| SCAPI > Troubleshoot > (default) Timeouts | |||
| Shopper-API Read/Write | 10s | 504 | Yes |
| Custom-API Read/Write (Shopper) | 60s (10s recommended) | 504 | Yes. For details, see Timeouts API and Custom API Limitations. |
| Custom-API Read/Write (Admin) | 60s | 504 | Yes. For details, see Timeouts API and Custom API Limitations. |
| Admin-API Read/Write | 60s | 504 | Yes. For details, see Timeouts API. |
| Hook Execution (per hook) | |||
| Shopper-API | 10s | 500 | Yes |
| Admin-API | 60s | 500 | Yes |
Limits
SCAPI enforces the following request and response size constraints to ensure optimal performance and system stability.
| Type | Limit | HTTP status code if exceeded | Customizable |
|---|---|---|---|
| SCAPI > Troubleshoot > Timeouts and Limits | |||
| Max. request line (URL) and headers | 24kB | 400 | No |
| Max request payload | 5MB | 413 | No |
| Max response payload | 10MB | 500 | No |
| Script API - Quotas (Hooks & Custom APIs) | |||
| Default limit | API Quotas | 400 | Yes. For details, see Implement Quota Overrides |
| Storefront Limit | API Quotas | 400 | Yes. For details, see Implement Quota Overrides |
| Hook Circuit Breaker | |||
| 50 hook errors within last 100 requests | OCAPI Hook Circuit Breaker | 503 | No |