Debugging API Responses

The Katalys API returns intelligent response codes and error messages. If you are having issues with the Katalys API, please refer to the following steps to help guide how to fix errors you might encounter.

• Ensure that your endpoint is correct.

  • Check the url. Are you sure that your code is hitting api.katalys.com?

  • Check the URL’s protocol, ensure it is https://

• Log the HTTP response code so you know what status the server is sending.

  • Your code should check that the return HTTP status is 200. If not, print the return body to your logs so you know what’s happening.

  • If you get an error, print the HTTP code to your logs. Response codes are:

    • 400: you made an error in your request.

    • 403: your authentication header is missing or incorrect.

    • 405: you are not sending a POST request

• Ensure that your request is sending the right data.

  • Ensure you are using a POST request type. If you use a GET request you will not receive the correct response and should instead see an HTTP 405 “Method Not Allowed” response.

  • Ensure you are sending the header content-type: application/json so that your request is parsed correctly. 

• Look at the error response body for the error: value. You should be seeing an error message that helps you understand what steps you might need to take.