Troubleshooting Guide

Find solutions to common issues and errors when working with the Eseni API and SDKs.

Common Errors & Solutions

Error 401 - Unauthorized

Request missing valid API key or authentication credentials.

Solution:

  1. Ensure your API key is correctly set in headers: Authorization: Bearer YOUR_KEY
  2. Regenerate your API key in the developer settings
  3. Verify rate limits haven't been exceeded
View Authentication Docs →

Error 429 - Rate Limit

API requests exceeded your plan's rate limit.

Solution:

  1. Check for Retry-After header for wait time
  2. Upgrade your API plan in the dashboard
  3. Implement rate limit awareness in your client
View Rate Limit Docs →

Error 400 - Bad Request

Invalid request format or missing required parameters.

Solution:

  1. Check required request headers: Content-Type: application/json
  2. Validate JSON body with schema
  3. Use the API console to test requests
View API Docs →

Error 503 - Service Unavailable

Temporary service disruption. The API is currently unavailable.

Solution:

  1. Wait for Retry-After time in response header
  2. Check the service status page
  3. Contact support for prolonged outages
View Status Docs →

Example Error Handling

JavaScript Example


fetch('https://api.eseni.dev/v1/endpoint', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
})
  .catch(error => {
    console.error('Network error:', error);
    // Handle retry logic here
  })
  .then(response => {
    if (response.status === 429) {
      console.log('Rate limited, retrying in:', response.headers.get('Retry-After'));
    }
    return response.json();
  })
  .then(data => {
    // Handle response
  });

Python Example


import requests

response = requests.get('https://api.eseni.dev/v1/endpoint', 
                          headers={'Authorization': 'Bearer YOUR_API_KEY'})

if response.status_code == 401:
    print('Authentication required')
elif response.status_code == 429:
    retry_after = response.headers.get('Retry-After')
    print(f'Rate limited. Retry after {retry_after or "wait time"} seconds')

Advanced Troubleshooting

Header Inspection

Verify headers include required authentication and content type information:

Authorization: Bearer YOUR_API_KEY Content-Type: application/json Accept: application/json
View Header Details →

CORS Issues

Ensure your API client isn't blocked by CORS in browser environments. Use a proxy if necessary.

Access-Control-Allow-Origin: https://your-origin.com
CORS Configuration →

Still having issues?

Our support team and community are here to help you resolve complex issues.

🚀 Ask in Discord 📧 Contact Support