Troubleshoot
Navigate through our API troubleshooting information to efficiently address and resolve issues you encounter.
Use this table as a first-stop navigation aid. It points to likely starting resources, not definitive root causes.
| Symptom | Start Here | Next Check |
|---|---|---|
| 504 Gateway Timeout | Troubleshoot Request Timeouts | Timeouts and Limits, Code Profiler |
| 429 Too Many Requests | Throttle Rates | Error Response Codes |
| 401/403 authorization errors | Authorization | Authorization Scopes, SLAS |
| 400 request validation errors | Error Response Codes | Commerce API references |
| 500/internal errors | SCAPI Logs and Request Tracking | Code Profiler |
| Unexpected response behavior | Response Handling | Commerce API references |
The B2C Commerce APIs provide capabilities to help you:
- Analyze response bodies to identify maintenance issues and actions to take.
- Check error response codes.
- Set rate limits.
- Timeouts.
- Monitor SCAPI API performance.
- View SCAPI logs and track requests.
- Timeouts and Limits.
When you encounter an API issue, follow these steps:
Every SCAPI response includes a correlationID header. Use this to track and investigate request details.
- Review the HTTP status code and response body
- Look for error messages and error details in the response
- See Error Response Codes for common status codes
Use Log Center in Business Manager to:
- Search by
correlationID - Enable
verboselogging for detailed request traces - Filter for errors and exceptions
- See SCAPI Logs and Request Tracking
If performance is an issue:
- Use Code Profiler to identify bottlenecks
- Check Reports & Dashboards for average response times
- Review cache hit rates and optimization opportunities
- Confirm authentication and authorization setup
- Check site preferences and locale settings
- Verify custom code and hooks aren’t causing issues
- Reproduce the issue in a test environment
- Isolate the problem by simplifying the request
- Use Postman or API testing tools to verify API behavior