Timeouts and Limits
SCAPI enforces timeout thresholds and size limits to ensure optimal performance and system stability.
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) | 10s | 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 |
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 |