API Quickstart

const fetch = require('node-fetch');

const JOBHIVE_API_KEY = process.env.JOBHIVE_API_KEY;
const BASE_URL = 'https://backend.jobhive.ai/v1';

async function createInterview() {
  const response = await fetch(`${BASE_URL}/interviews`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${JOBHIVE_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      candidate_email: 'john.doe@example.com',
      position: 'Full Stack Developer',
      skills: ['JavaScript', 'React', 'Python', 'Django'],
      duration_minutes: 45,
      difficulty: 'intermediate'
    })
  });

  const interview = await response.json();
  console.log('Interview created:', interview.data.id);
  console.log('Share this link:', interview.data.interview_url);
  
  return interview.data;
}

async function getResults(interviewId) {
  const response = await fetch(`${BASE_URL}/interviews/${interviewId}?include_results=true`, {
    headers: {
      'Authorization': `Bearer ${JOBHIVE_API_KEY}`
    }
  });

  const interview = await response.json();
  
  if (interview.data.status === 'completed') {
    console.log('Overall Score:', interview.data.results.overall_score);
    console.log('Recommendation:', interview.data.results.recommendation);
    console.log('Strengths:', interview.data.results.strengths);
  }
  
  return interview.data;
}

// Usage
createInterview()
  .then(interview => {
    console.log('Waiting for interview completion...');
    // In practice, use webhooks for real-time updates
    setTimeout(() => getResults(interview.id), 60000); // Check after 1 minute
  })
  .catch(console.error);

import requests
import os
import time

JOBHIVE_API_KEY = os.environ['JOBHIVE_API_KEY']
BASE_URL = 'https://backend.jobhive.ai/v1'

def create_interview():
    response = requests.post(f'{BASE_URL}/interviews', 
        headers={
            'Authorization': f'Bearer {JOBHIVE_API_KEY}',
            'Content-Type': 'application/json'
        },
        json={
            'candidate_email': 'alice.johnson@example.com',
            'position': 'Data Scientist',
            'skills': ['Python', 'Machine Learning', 'SQL', 'Pandas'],
            'duration_minutes': 60,
            'difficulty': 'senior'
        }
    )
    
    interview = response.json()
    print(f"Interview created: {interview['data']['id']}")
    print(f"Share this link: {interview['data']['interview_url']}")
    
    return interview['data']

def get_results(interview_id):
    response = requests.get(f'{BASE_URL}/interviews/{interview_id}?include_results=true',
        headers={'Authorization': f'Bearer {JOBHIVE_API_KEY}'}
    )
    
    interview = response.json()
    
    if interview['data']['status'] == 'completed':
        results = interview['data']['results']
        print(f"Overall Score: {results['overall_score']}")
        print(f"Technical Score: {results['technical_score']}")
        print(f"Communication Score: {results['communication_score']}")
        print(f"Recommendation: {results['recommendation']}")
        
        print("\nStrengths:")
        for strength in results['strengths']:
            print(f"  ✅ {strength}")
            
        print("\nAreas for Improvement:")
        for area in results['areas_for_improvement']:
            print(f"  📈 {area}")
    
    return interview['data']

# Usage
if __name__ == "__main__":
    interview = create_interview()
    
    print("Waiting for interview completion...")
    # In practice, use webhooks for real-time updates
    time.sleep(60)  # Wait 1 minute then check
    get_results(interview['id'])

async function createBulkInterviews(candidates) {
  const interviews = [];
  
  for (const candidate of candidates) {
    const interview = await fetch(`${BASE_URL}/interviews`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${JOBHIVE_API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        candidate_email: candidate.email,
        position: candidate.position,
        skills: candidate.skills,
        duration_minutes: 30
      })
    });
    
    interviews.push(await interview.json());
  }
  
  return interviews;
}

// Usage
const candidates = [
  { email: 'dev1@example.com', position: 'Frontend Developer', skills: ['React', 'TypeScript'] },
  { email: 'dev2@example.com', position: 'Backend Developer', skills: ['Node.js', 'PostgreSQL'] },
  { email: 'dev3@example.com', position: 'Full Stack Developer', skills: ['React', 'Node.js'] }
];

createBulkInterviews(candidates)
  .then(results => console.log(`Created ${results.length} interviews`))
  .catch(console.error);

const express = require('express');
const crypto = require('crypto');

const app = express();
app.use(express.json());

function verifyWebhook(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(`sha256=${expectedSignature}`)
  );
}

app.post('/webhooks/jobhive', (req, res) => {
  const signature = req.headers['x-jobhive-signature'];
  const payload = JSON.stringify(req.body);
  
  if (!verifyWebhook(payload, signature, process.env.JOBHIVE_WEBHOOK_SECRET)) {
    return res.status(401).send('Invalid signature');
  }
  
  const { event, data } = req.body;
  
  switch(event) {
    case 'interview.started':
      console.log(`🎬 Interview ${data.id} started by ${data.candidate.email}`);
      // Notify hiring team
      break;
      
    case 'interview.completed':
      console.log(`✅ Interview ${data.id} completed`);
      console.log(`📊 Score: ${data.results.overall_score}`);
      console.log(`💡 Recommendation: ${data.results.recommendation}`);
      
      // Auto-schedule next round for strong candidates
      if (data.results.overall_score >= 80) {
        scheduleHumanInterview(data);
      }
      break;
      
    case 'candidate.no_show':
      console.log(`❌ Candidate ${data.candidate_email} didn't show for interview ${data.interview_id}`);
      // Send follow-up email
      break;
  }
  
  res.status(200).send('OK');
});

app.listen(3000, () => {
  console.log('Webhook server running on port 3000');
});