API

Documentation

Version 1.0

SDKs & Libraries

To make integration with the AutoTechJobs API easier, we provide official SDKs for popular programming languages and frameworks. These SDKs handle authentication, request formatting, and response parsing, allowing you to focus on building your application.

SDK Benefits

  • Simplified authentication and request handling
  • Type-safe interfaces with proper error handling
  • Automatic rate limit handling with retries
  • Comprehensive documentation and examples
  • Regular updates to support new API features

Official SDKs

JavaScript/TypeScript

Our JavaScript SDK works in both Node.js and browser environments, with full TypeScript support.

npm install @autotechjobs/api-sdk
View on GitHub →

Python

A Python SDK with support for synchronous and asynchronous requests, compatible with Python 3.7+.

pip install autotechjobs-api
View on GitHub →

PHP

A PHP SDK that works with PHP 7.4+ and integrates with popular frameworks like Laravel and Symfony.

composer require autotechjobs/api-client
View on GitHub →

Go

A Go client library with strong typing and support for context-based cancellation and timeouts.

go get github.com/autotechjobs/go-sdk
View on GitHub →

Community Libraries

In addition to our official SDKs, the community has developed libraries for various languages and frameworks. While not officially supported, these libraries can be valuable resources:

Language/FrameworkLibraryAuthorLink
Rubyautotechjobs-ruby@rubydevGitHub
Javaautotechjobs-java-client@javaconnectGitHub
C#/.NETAutoTechJobs.NET@dotnetdevGitHub
Rustautotechjobs-rs@rustcoderGitHub

Community Library Disclaimer

Community libraries are not officially maintained or supported by AutoTechJobs. While we appreciate the community's contributions, we recommend using our official SDKs for production applications. Always review third-party code before integrating it into your projects.

Example Usage

JavaScript/TypeScript

import { AutoTechJobsClient } from '@autotechjobs/api-sdk';

// Initialize the client with your API key
const client = new AutoTechJobsClient('your_api_key');

// Fetch jobs with filtering and sorting
async function getJobs() {
  try {
    const jobs = await client.jobs.list({
      location: 'london',
      job_type: 'full-time',
      sort: 'posted_at:desc',
      limit: 10
    });
    
    console.log(`Found ${jobs.meta.pagination.total} jobs`);
    jobs.data.forEach(job => {
      console.log(`${job.title} at ${job.company_name}`);
    });
  } catch (error) {
    console.error('Error fetching jobs:', error);
  }
}

Python

from autotechjobs_api import AutoTechJobsClient

# Initialize the client with your API key
client = AutoTechJobsClient(api_key='your_api_key')

# Create a new job posting
try:
    job = client.jobs.create({
        'title': 'Automotive Technician',
        'description': 'Experienced technician needed for luxury vehicle servicing...',
        'location': 'Manchester',
        'salary_min': 35000,
        'salary_max': 45000,
        'job_type': 'full-time',
        'skills': ['diagnostics', 'electric', 'hybrid']
    })
    
    print(f'Job created with ID: {job["id"]}')  
    
    # Set up a webhook for applications
    webhook = client.webhooks.create({
        'url': 'https://your-app.com/webhooks/applications',
        'events': ['application.created', 'application.updated'],
        'description': 'Notification for new job applications'
    })
    
    print(f'Webhook created with ID: {webhook["id"]}')  
    
except Exception as e:
    print(f'Error: {e}')

Contributing

We welcome contributions to our official SDKs! If you'd like to contribute, please check out ourGitHub repositoryand review the contribution guidelines.

If you've developed a library for a language or framework we don't officially support, please let us know so we can add it to our community libraries list.

For more information on using the API directly without an SDK, see theAuthenticationdocumentation.