Documentation

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "error": {
    "code": "invalid_request",
    "message": "The job title field is required",
    "documentation_url": "https://api.autotechjobs.co.uk/docs/api/errors#invalid_request",
    "param": "title",
    "details": [
      {
        "field": "title",
        "message": "This field is required"
      }
    ]
  }
}

async function createJob(jobData) {
  try {
    const response = await fetch('https://api.autotechjobs.co.uk/v1/jobs', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify(jobData)
    });
    
    const data = await response.json();
    
    if (!response.ok) {
      // Handle API errors
      const error = data.error;
      
      switch (error.code) {
        case 'validation_error':
          // Handle validation errors
          const fieldErrors = error.details.reduce((acc, detail) => {
            acc[detail.field] = detail.message;
            return acc;
          }, {});
          
          console.error('Validation errors:', fieldErrors);
          // Update your UI to show validation errors
          break;
          
        case 'rate_limit_exceeded':
          // Handle rate limiting
          const resetTime = new Date(parseInt(response.headers.get('X-RateLimit-Reset')) * 1000);
          console.error(`Rate limit exceeded. Try again after ${resetTime.toLocaleTimeString()}`);
          // Maybe schedule a retry after the reset time
          break;
          
        default:
          // Handle other errors
          console.error(`API Error: ${error.code} - ${error.message}`);
          // Show a generic error message to the user
      }
      
      return { success: false, error };
    }
    
    return { success: true, data: data.data };
  } catch (error) {
    // Handle network errors
    console.error('Network error:', error);
    return { 
      success: false, 
      error: { 
        code: 'network_error', 
        message: 'A network error occurred. Please check your connection and try again.' 
      } 
    };
  }
}

import requests
import time

def create_job(job_data, api_key):
    try:
        response = requests.post(
            'https://api.autotechjobs.co.uk/v1/jobs',
            json=job_data,
            headers={
                'Authorization': f'Bearer {api_key}',
                'Content-Type': 'application/json'
            }
        )
        
        # Parse the response
        data = response.json()
        
        # Check if the request was successful
        if response.status_code >= 400:
            error = data.get('error', {})
            error_code = error.get('code')
            error_message = error.get('message')
            
            if error_code == 'validation_error':
                # Handle validation errors
                field_errors = {detail['field']: detail['message'] for detail in error.get('details', [])}
                print(f'Validation errors: {field_errors}')
                # Update your UI to show validation errors
                
            elif error_code == 'rate_limit_exceeded':
                # Handle rate limiting
                reset_time = int(response.headers.get('X-RateLimit-Reset', 0))
                wait_time = max(0, reset_time - int(time.time()))
                print(f'Rate limit exceeded. Try again after {wait_time} seconds')
                # Maybe sleep and retry
                
            else:
                # Handle other errors
                print(f'API Error: {error_code} - {error_message}')
                # Show a generic error message to the user
                
            return {'success': False, 'error': error}
        
        return {'success': True, 'data': data.get('data')}
        
    except requests.exceptions.RequestException as e:
        # Handle network errors
        print(f'Network error: {str(e)}')
        return {
            'success': False,
            'error': {
                'code': 'network_error',
                'message': 'A network error occurred. Please check your connection and try again.'
            }
        }