Common

Plugin Troubleshooting

Post Plugin

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 SKT API returned 401 (Unauthorized). Ensure username and password are correct.”

Credentials for the SKT API are incorrect.

400 Bad Request

”The SKT 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 SKT 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 SKT API returned 500 (Internal Error).”

The  API experienced an internal error and failed to complete the post request.

Unknown error.

”The SKT 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 SKT 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 SKT API. For additional details on each error message, refer to the Debug Logs page.

Error Message

Actual Exception Text

Cause

401 Unauthorized

”The SKT API returned 401 (Unauthorized). Ensure username and password are correct.”

Credentials for the SKT API are incorrect.

429 Too Many Requests

”The SKT 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 SKT 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.