Substance 3D API Troubleshooting Guide
This guide explains common issues when using the Adobe Substance 3D API. For problems not covered here, refer to the API documentation or contact Adobe support.
Authentication failure
An authentication error can occur when the credentials aren't correct.
Sample error
Copied to your clipboard{"error_code": "access_error","message": ""}
- Verify the client ID and client secret.
- Be sure the OAuth 2.0 token is valid and hasn't expired.
- Check that the API endpoint URL is correct and supports the authentication method.
Rate limit exceeded
The rate limit is the maximum number of requests that can be made to the API in a given time. An error can occur when the rate limit is exceeded.
Sample error
Copied to your clipboard{"error_code": "rate_limited","message": ""}
- Implement exponential backoff and the retry logic to handle rate limiting.
- Reduce the frequency of API calls or optimize the code to make fewer requests.
Unexpected API response
Errors can be the result of unprocessable entities or other validation errors in the request.
Sample error
Copied to your clipboard{"error_code": "invalid_content_type","message": ""}
- Check the API reference for the correct request format and parameters.
- Verify that the request is correctly formatted and includes all required parameters.
- Use logging and debugging tools to inspect the API response for any issues.
Internal server error (HTTP 500)
This error indicates a problem on the server side.
Sample error
Copied to your clipboard{"error_code": "runtime_error","message": ""}
- Wait a few minutes and try your request again.
- If the issue persists, check the Adobe status page for any reported service disruptions.
Slow API response times
You may experience API response times that are longer than expected.
- Check your network connection and ensure that it's stable and fast.
- Optimize your code to reduce the amount of data sent in API requests.
- Consider using a CDN or caching strategy to reduce latency for static resources.
