API Documentation

Authorization: Bearer YOUR_API_KEY

POST /api/v1/batch-jobs/sync
{
    "input_type": "CSV_FILE",
    "job_description_text": "Your job description here...",
    "max_candidates": 50,
    "timeout": 300
}

candidate_id,name,resume_text,filename
1,John Doe,"Software Engineer with 5 years Python experience...",john_doe.pdf
2,Jane Smith,"Data Scientist specializing in machine learning...",jane_smith.docx

import requests
from datetime import datetime
import json

# Weekly batch processing
def process_weekly_candidates():
    # Upload ZIP file with all resumes
    with open('weekly_resumes.zip', 'rb') as f:
        files = {'candidate_source_file': f}
        data = {
            'input_type': 'ZIP_FILE',
            'job_description_text': get_job_description('tech_role_2024'),
            'metadata_json': json.dumps({
                'job_profile': {
                    'title': 'Senior Full Stack Developer',
                    'department': 'Engineering',
                    'location': 'Remote'
                },
                'tags': ['urgent', 'high-priority'],
                'client_id': 'client_123'
            })
        }
        
        response = requests.post(
            'https://api.skillmatchiq.com/api/v1/batch-jobs',
            files=files,
            data=data,
            headers={'Authorization': f'Bearer {API_KEY}'}
        )
    
    batch_id = response.json()['batch_job_id']
    
    # Wait for completion and get results
    results = wait_and_get_results(batch_id)
    
    # Email top 10 matches to client
    top_matches = results['processed_items'][:10]
    send_client_report(top_matches, 'client_123')

# Database configuration for PostgreSQL
source_config = {
    "type": "postgresql",
    "connection_string": "postgresql://hr_user:pass@localhost:5432/ats",
    "query": "SELECT id, name, resume_content FROM applicants WHERE position_id = 12345"
}

# Submit batch job with database source
response = requests.post(
    'https://api.skillmatchiq.com/api/v1/batch-jobs',
    data={
        'input_type': 'DATABASE',
        'job_description_text': job_description,
        'source_config_json': json.dumps(source_config),
        'metadata_json': json.dumps({
            'ats_integration': True,
            'position_id': 12345
        })
    },
    headers={'Authorization': f'Bearer {API_KEY}'}
)

# Process student resumes from Google Drive
config = {
    "folder_id": "1a2b3c4d5e6f7g8h9i0j",
    "credentials": {
        # OAuth2 credentials
    }
}

# Match against multiple internship positions
for position in internship_positions:
    response = requests.post(
        'https://api.skillmatchiq.com/api/v1/batch-jobs',
        data={
            'input_type': 'GOOGLE_DRIVE',
            'job_description_text': position['description'],
            'source_config_json': json.dumps(config),
            'metadata_json': json.dumps({
                'position_type': 'internship',
                'semester': 'Spring 2024',
                'department': position['department']
            })
        },
        headers={'Authorization': f'Bearer {API_KEY}'}
    )
    
    # Store results for student advisors
    batch_id = response.json()['batch_job_id']
    track_internship_matches(position['id'], batch_id)

{
    "error": {
        "code": "INVALID_INPUT_TYPE",
        "message": "Invalid value for 'input_type' field",
        "details": {
            "field": "input_type",
            "provided": "zip",
            "expected": ["ZIP_FILE", "CSV_FILE", "GOOGLE_DRIVE", "AWS_S3", "DATABASE"]
        }
    }
}