Troubleshooting Outbound REST API in Qntrl | Web Services Online Help | Qntrl Online Help

Troubleshooting

1. Cannot execute API     

  1. Make sure all required fields are filled in correctly — this includes the URL, query parameters, headers, and request body. Missing or incorrect values can prevent the API from executing successfully.

2. Unauthorized or forbidden error (401/403)     

  1. Missing Authorization Header: Add the required authentication in the Headers section.

3. Invalid or broken endpoint (400/404)     

  1. Incorrect API URL: Confirm the full endpoint URL is correct, including path variables.
  2. Missing Query Parameters: Ensure mandatory parameters are passed either as static values or variables.


4. REST response returns errors

  • Invalid input parameters: Ensure all required parameters (in query, header, or body) are passed and formatted correctly. Validate against the external API's specification.
  • Server errors:
    • 400 – Server unreachable: Check the endpoint URL and your network/DRE connection.
    • 404 – Not found: Verify the API URL path and that the resource exists on the external server.
    • 500 – Internal server error: Indicates an issue with the external service. Check their server logs or contact the API provider for support.

5. Variables not replaced in request     

  1. Missing Variable Inputs: When executing via script or Codex, ensure all dynamic variables (e.g., {{jobId}}) are passed as a JSON object.
  2. Incorrect Syntax: Use double curly braces ({{variableName}}) for local variables and ${configVariable} for Config Store values.

6. Request Time Out     

  1. Slow External Server: The external API might be unresponsive or slow.
  2. Low Timeout Limit: Increase the Connection Timeout value under the Settings tab as needed. 

7. SSL Certificate Verification Fails     

  1. Invalid or Self-Signed Certificate: Disable SSL Certificate Verification if testing with an untrusted or local endpoint.
  2. Mismatched Hostname: Ensure the certificate matches the host name and port in the API URL.

8.  Applied Response Not Displaying     

  1. Response Parser Not Configured: Add required fields in the Response Parser using suggested JSON paths.
  2. Postscript Modifying Output: Review the Postscript for overwrites or null assignments to expected fields.

9. Prescript/Postscript Not Executing     

  1. Script Errors: Check script syntax and log values to troubleshoot.
  2. Undefined Variables: Declare all used variables and ensure they are correctly named.