Troubleshooting the API Hub
This guide helps you identify and resolve common issues encountered while using UniDeck's API Hub.
Common Issues and Solutions
Issue 1: API Requests Fail with No Response
If your API requests do not receive responses or timeout:
Check Endpoint URL:
Verify the endpoint URL entered in the Request Editor is correct.
Ensure there are no trailing spaces or missing protocol specifications (
https://
).
Review Network Connectivity:
Ensure you have stable internet connectivity.
Confirm that your firewall or network policy does not block API requests.
Issue 2: Incorrect Response or Data Format
If responses are returned but not as expected:
Validate Request Parameters:
Double-check the parameters and request body entered in the Request Editor.
Ensure headers (e.g., Content-Type, Accept) are correctly specified.
Inspect Response Format:
Use UniDeck’s Response Viewer to verify response headers and data format.
Adjust your requests based on the actual response format (JSON, XML, plain text).
Issue 3: Authentication Errors
If your API call returns authentication errors (401 Unauthorized or 403 Forbidden):
Verify Credentials and Tokens:
Confirm that authentication credentials (API keys, OAuth tokens, etc.) are correctly entered.
Ensure tokens have not expired; regenerate tokens if necessary.
Check Authorization Headers:
Make sure you include proper authorization headers as required by your API.
Using Response Viewer for Troubleshooting
The Response Viewer provides insights into each API response:
Status Codes:
Refer to status codes (e.g., 200, 400, 401, 500) to quickly identify response categories.
Headers Inspection:
Headers can reveal issues like incorrect content-type or authentication problems.
Response Body:
Carefully examine the returned body for error messages or unexpected data.

Request Editor Verification
Ensure correct request setups by reviewing the following in the Request Editor:
HTTP Method (GET, POST, PUT, DELETE):
Verify that the correct HTTP method is selected according to your API documentation.
Request Body and Parameters:
Confirm request body formats (e.g., JSON payload) align with API requirements.
Headers and Authentication:
Cross-check headers, especially content types and authorization headers.
Advanced Troubleshooting
If issues persist after performing the above steps:
Consult API Logs:
Review detailed API logs from your API provider or internal logging mechanisms.
Contact API Support:
If an external API consistently fails, consult their official documentation or support team.
UniDeck Support:
For persistent issues related to UniDeck’s API Hub functionality, contact UniDeck support via support@unideck.app.
This structured troubleshooting approach helps swiftly identify, diagnose, and solve common API integration challenges within UniDeck’s API Hub.
Last updated