Inbound REST API | Troubleshooting REST API | Qntrl Online Help

Troubleshooting

 1. Cannot create inbound REST module     

  • Missing required fields: Ensure Name, Base URI, and Authentication Type are provided.
  • Duplicate base URI: Use a unique base URI for each module.
  • Invalid base URI format: The base URI should begin with a / and contain no spaces or special characters.

2. API endpoint not getting triggered     

  • Incorrect endpoint path: Verify that the final URL includes the correct base URI and endpoint path.
  • Function or Circuit not linked: Ensure a valid resource is selected.
 

3. Request fails with 400 error     

  • Missing mandatory parameters: Ensure all required parameters are included in the request.
  • Incorrect parameter format: Match the data types (e.g., number, text) and allowed values.
  • Regex or length mismatch: Input may not meet defined pattern or length constraints.

 

4. Request body issues     

  • Wrong body type selected: Choose the correct body format—Raw, x-www-form-urlencoded, or None.
  • File upload not working: File uploads are only supported with Function resources, not Circuits.
  • Min/Max length not satisfied: Ensure the body content respects the length validation rules if set.
 

5. Authentication failures     

  • Invalid OAuth token: Make sure the token is valid and includes the correct scopes.
  • Incorrect API key: Check if the API key provided matches the one set in Qntrl.
  • Missing authorization header: Ensure the required authentication headers are passed correctly.
 

6. Rate limit errors     

  • Too many requests (429 Error): The request rate has exceeded the defined limit.
  • Wrong policy attached: Confirm the correct rate limit policy is selected.
  • Per-IP not working as expected: Review whether the Per-IP option is enabled as needed.
 

7. Function not executing as expected   

  • Function not appearing in the dropdown: Only REST-type functions are listed; ensure the script is created under REST.
  • No logs or output: View function execution logs for runtime errors.
  • Function throws an error: Check script logs under the function execution. Validate all parameters before use.
 

Best practices  

  • Use Postman or CURL to test the endpoint during development.
  • If using OAuth, ensure the correct scope is set and token is valid.
  • Always test each endpoint before publishing.
  • Refer to API logs for real-time debugging of requests and failures.

    • Related Articles

    • Troubleshooting Outbound SOAP

      1. WSDL URL fetch failure Invalid WSDL URL: Verify the WSDL URL and ensure it is accessible. Test the URL in a browser. Authentication required: If authentication is needed, provide the correct credentials. 2. Cannot modify WSDL contract Downloaded ...

    • Test/Execute a Circuit

      Once you configured your circuit, you have two options: Save: To save your current circuit configuration. Save and Execute: To save and immediately execute the circuit. When you choose Save and Execute: A pop-up window with predefined JSON input will ...

    • Troubleshooting Outbound REST Web Services

      1. Cannot execute API 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 ...

    • Troubleshooting in Inbound SOAP Webservices

      1. Cannot receive incoming SOAP requests Incorrect endpoint URL: Ensure clients are calling the correct Qntrl endpoint. Firewall restrictions: Allow inbound requests through the firewall. Authentication failure: Ensure proper authentication ...

    • Other actions in Bridge

      View / Edit Bridge properties Follow the given steps to view or edit the properties of a bridge: Click the settings gear icon located in the left pane. Navigate to Advanced >> Bridge >> choose Bridge. In the Bridge list page, choose the specific ...

    You are currently viewing the help articles of Qntrl 3.0. If you are still using our older version and require guidance with it, Click here.