Common
Plugin Troubleshooting
The post plugin can throw the following exceptions due to connectivity issues with Syniti’s REST API. For additional details on each error message, refer to the Debug Logs page.
|
Error Message |
Actual Exception Text |
Cause |
|
401 Unauthorized |
”The Knowledge Tier API returned 401 (Unauthorized). Ensure username and password are correct.” |
Credentials for the Knowledge Tier API are incorrect. |
|
400 Bad Request |
”The Knowledge Tier API returned 400 (Bad Request). The asset object was malformed. This could be an error with the asset mapping data.” |
Some part of the json object sent to the post endpoint was incorrect. More detail can be seen in the error logs for this type of response code. |
|
429 Too Many Requests |
”The Knowledge Tier API returned 429 (Rate Limited) after waiting for a reset. This could be due to heavy traffic.” |
The rate limit of the API has been exceeded; the post plugin code waited for the reset window to elapse and then again got the 429 response error on the next request. This could be due to high traffic against the API. If the second request after waiting for a reset is successful, no error is thrown and the plugin continues. |
|
500 Internal Error: |
”The Knowledge Tier API returned 500 (Internal Error).” |
The API experienced an internal error and failed to complete the post request. |
|
Unknown error. |
”The Knowledge Tier API returned an unknown status code. Status {status code}.” |
Any non-successful status code is returned from contacting the API. The error code is shown to the user and further details of the error are stored in the logs.Get Plugin The get plugin can throw the following exceptions due to connectivity issues with the Knowledge Tier API. For additional details on each error message, refer to the Debug Logs page. |
Get Plugin
The get plugin can throw the following exceptions due to connectivity issues with the Knowledge Tier API. For additional details on each error message, refer to the Debug Logs page.
|
Error Message |
Actual Exception Text |
Cause |
|
401 Unauthorized |
”The Knowledge Tier API returned 401 (Unauthorized). Ensure username and password are correct.” |
Credentials for the Knowledge Tier API are incorrect. |
|
429 Too Many Requests |
”The Knowledge Tier API returned 429 (Rate Limited) after waiting for a reset. This could be due to heavy traffic.” |
The rate limit of the API has been exceeded; the get plugin code has waited for the reset window to elapse and then again got the 429 response error on the next request. This could be due to high traffic against the API. If the second request after waiting for a reset is successful no error is thrown and the plugin continues. |
|
Unknown error |
”The Knowledge Tier API returned an unknown status code. Status {status code}.” |
Any non-successful status code is returned from contacting the API. The error code is shown to the user and further details of the error are stored in the logs. |
Put Plugin
The put plugin can throw the following exceptions due to connectivity issues with Syniti’s REST API. For additional details on each error message, refer to the Debug Logs page.
|
Error Message |
Actual Exception Text |
Cause |
|
401 Unauthorized |
”The Knowledge Tier API returned 401 (Unauthorized). Ensure username and password are correct.” |
Credentials for the Knowledge Tier API are incorrect. |
|
400 Bad Request |
”The Knowledge Tier API returned 400 (Bad Request). The asset object was malformed. This could be an error with the asset mapping data.” |
Some part of the json object sent to the post endpoint was incorrect. More detail can be seen in the error logs for this type of response code. |
|
429 Too Many Requests |
”The Knowledge Tier API returned 429 (Rate Limited) after waiting for a reset. This could be due to heavy traffic.” |
The rate limit of the API has been exceeded; the post plugin code waited for the reset window to elapse and then again got the 429 response error on the next request. This could be due to high traffic against the API. If the second request after waiting for a reset is successful, no error is thrown and the plugin continues. |
|
500 Internal Error: |
”The Knowledge Tier API returned 500 (Internal Error).” |
The API experienced an internal error and failed to complete the post request. |
|
Unknown error. |
”The Knowledge Tier API returned an unknown status code. Status {status code}.” |
Any non-successful status code is returned from contacting the API. The error code is shown to the user and further details of the error are stored in the logs.Get Plugin The get plugin can throw the following exceptions due to connectivity issues with the Knowledge Tier API. For additional details on each error message, refer to the Debug Logs page. |
|
404 Not Found |
"The SKT API returned 404 (Not Found). Ensure the mapping information has the correct asset endpoint." |
Tried to update something that was not found in the Knowledge Tier. |
