Common Issues

Learn about common issues you might encounter while using Wayvo and how to resolve them.

Common Issues

While using Wayvo, you may encounter some common issues. This section provides troubleshooting tips and solutions for resolving these issues.

Authentication Issues

1. Invalid API Key or Token

   • Description: API requests return a 401 Unauthorized error.
   • Solution:
     • Ensure that you are using a valid API key or access token.
     • Check if the token has expired and request a new one if necessary.
     • Verify that the API key or token is included correctly in the request headers.

   curl -X GET "https://api.wayvo.ai/v1/users" -H "Authorization: Bearer YOUR_API_KEY"
   

2. Permission Denied

   • Description: API requests return a 403 Forbidden error.
   • Solution:
     • Ensure that your API key or token has the necessary permissions to access the resource.
     • Verify that your user account has the required roles and permissions.

Connection Issues

1. Unable to Connect to Data Source

   • Description: Wayvo cannot connect to your database or external service.
   • Solution:
     • Verify the connection details (host, port, credentials) are correct.
     • Ensure that the database or service is up and accessible.
     • Check for any network or firewall issues that might be blocking the connection.

   {
     "type": "sql",
     "host": "your-database-host",
     "port": 5432,
     "database": "your-database-name",
     "username": "your-username",
     "password": "your-password"
   }
   

Data Retrieval Issues

1. No Data Returned

   • Description: API requests or database queries return no data.
   • Solution:
     • Verify that the data exists in the database or external service.
     • Check your query or API request parameters for accuracy.
     • Ensure that any filters applied are correct and appropriate.

   curl -X GET "https://api.wayvo.ai/v1/users?role=admin" -H "Authorization: Bearer YOUR_API_KEY"
   

2. Slow Data Retrieval

   • Description: Data retrieval is slow and affects application performance.
   • Solution:
     • Optimize your database queries or API requests.
     • Use indexing to speed up database queries.
     • Implement caching mechanisms to reduce load times.

Deployment Issues

1. Deployment Failure

   • Description: Application deployment fails with errors.
   • Solution:
     • Check the deployment logs for error messages.
     • Ensure that all environment variables and configurations are set correctly.
     • Verify that all dependencies are installed and up to date.

2. Application Not Accessible After Deployment

   • Description: The deployed application is not accessible or returns errors.
   • Solution:
     • Verify that the application is running and listening on the correct port.
     • Check for any firewall or network issues that might be blocking access.
     • Review the application logs to identify and resolve any errors.

Integration Issues

1. API Integration Failure

   • Description: Integration with an external API fails.
   • Solution:
     • Verify the API endpoint URL and request parameters.
     • Ensure that the correct headers and authentication tokens are included in the request.
     • Check for any rate limiting or quota issues with the external API.

   curl -X GET "https://api.external-service.com/v1/resource" -H "Authorization: Bearer YOUR_API_KEY"
   

2. Data Synchronization Issues

   • Description: Data synchronization between Wayvo and external services fails.
   • Solution:
     • Verify that the data mapping and transformation configurations are correct.
     • Check for any network issues that might be causing synchronization failures.
     • Ensure that the external service is up and running.

User Interface Issues

1. UI Components Not Displaying Correctly

   • Description: UI components are not rendering or displaying correctly.
   • Solution:
     • Check for any syntax errors or issues in your component configurations.
     • Ensure that all required data bindings and properties are set correctly.
     • Verify that the components are compatible with the current version of Wayvo.

2. Performance Issues

   • Description: The application UI is slow or unresponsive.
   • Solution:
     • Optimize the data retrieval and processing logic.
     • Minimize the use of heavy components and animations.
     • Use performance profiling tools to identify and resolve bottlenecks.

Best Practices for Troubleshooting

1. Log Errors

   • Enable logging in your application to capture error messages and stack traces.
   • Review logs regularly to identify and resolve issues.

2. Test Thoroughly

   • Test your application thoroughly in different environments to identify potential issues.
   • Use automated testing tools to ensure consistency and reliability.

3. Monitor Performance

   • Monitor your application's performance and resource usage.
   • Use monitoring tools to detect and address performance issues proactively.

Next Steps

With these solutions for common issues, you can troubleshoot and resolve problems more efficiently. Explore our guides on API Overview and Integration Guides for more information on using and integrating Wayvo.

For additional support, check out our Community and Support section.