HireAI Interview Platform

AI-Powered Real-time Voice Interview System

Gerçek zamanlı sesli mülakat ve otomatik aday değerlendirme platformu

Platform Özellikleri

AI-Powered Interviews

Gelişmiş yapay zeka ile gerçek zamanlı sesli mülakat sistemi

Real-time Communication

WebSocket ile düşük gecikmeli sesli iletişim

Smart Evaluation

Otomatik değerlendirme ve puanlama sistemi

Secure API

API key authentication ve rate limiting

Credit System

Kullanım bazlı esnek kredi sistemi

Conversation History

Tüm konuşma kayıtları ve transcript

Credit System

Kredi Sistemi Nedir?
HireAI API kullanım bazlı kredi sistemi ile çalışır. Her işlem belirli miktarda kredi tüketir. Krediniz bittiğinde API istekleri yapılamaz (402 Payment Required). Kredi paketleri satın alarak bakiyenizi yükseltebilirsiniz.

Kredi Maliyetleri

Mülakat Oluşturma 10 kredi
AI Mülakatı Başlatma 50 kredi
Dakika Başı Aktif Mülakat 5 kredi/dk
Mesaj Gönderme/Alma 1 kredi
Cevap Değerlendirme 3 kredi
Örnek Hesaplama
10 dakikalık bir mülakat yaklaşık 155 kredi (~$1.55) tutar:
• Mülakat oluşturma: 10 kredi
• Başlatma: 50 kredi
• 10 dakika aktif: 50 kredi
• ~30 mesaj: 30 kredi
• 5 değerlendirme: 15 kredi

Kredi Paketleri

Starter: 100 kredi - $1.00
Basic: 500 kredi - $4.50
Pro: 1000 kredi - $8.00
Business: 5000 kredi - $35.00
Enterprise: 10000 kredi - $60.00

Kredi API Endpoints

GET /api/credits/balance
GET /api/credits/packages
POST /api/credits/purchase
GET /api/credits/transactions
GET /api/credits/usage-breakdown
GET /api/credits/balance
Mevcut kredi bakiyenizi ve kullanım istatistiklerinizi görüntüleyin
curl https://interviewer.hiri.ai/api/credits/balance \
  -H "X-API-Key: your-api-key-here"
Response 200 OK
{
  "balance": 850,
  "stats": {
    "total_purchased": 1000,
    "total_used": 150,
    "purchase_count": 2,
    "usage_count": 45
  }
}
POST /api/credits/purchase
Kredi paketi satın alın
Request Body (JSON)
package_id uuid • optional
Hazır paket ID'si
amount number • optional
Özel miktar (package_id yoksa)
payment_method string • optional
Ödeme yöntemi bilgisi
curl -X POST https://interviewer.hiri.ai/api/credits/purchase \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -d '{
    "amount": 500,
    "payment_method": "credit_card"
  }'
GET /api/credits/transactions
Kredi işlem geçmişinizi görüntüleyin
curl https://interviewer.hiri.ai/api/credits/transactions?limit=50 \
  -H "X-API-Key: your-api-key-here"
Yetersiz Kredi
Kredi bakiyeniz yetersiz olduğunda API istekleriniz 402 Payment Required hatası döner. Bu durumda işleme devam edebilmek için kredi satın almanız gerekmektedir.

Authentication

API Key Authentication Required
Tüm API istekleri için X-API-Key header gereklidir.
API key olmadan yapılan istekler 401 Unauthorized hatası döner.
Admin işlemleri için X-Admin-Key header kullanılır.
POST /api/keys
Yeni API key oluşturur (Admin only - X-Admin-Key gerekli)
Request Body (JSON)
name string • required
API key açıklaması
rate_limit number • optional
Dakika başı istek limiti
expires_in_days number • optional
Geçerlilik süresi (gün)
curl -X POST https://interviewer.hiri.ai/api/keys \
  -H "Content-Type: application/json" \
  -H "X-Admin-Key: your-admin-key-here" \
  -d '{
    "name": "Production Key",
    "rate_limit": 1000,
    "expires_in_days": 365
  }'

Interview Workflow

1

Aday Oluştur

POST /api/candidates ile adayın bilgilerini kaydedin

2

Pozisyon Tanımla

POST /api/positions ile iş pozisyonu ve gereksinimlerini belirleyin

3

Mülakat Oluştur

POST /api/interviews ile aday ve pozisyonu eşleştirin (10 kredi)

4

Mülakatı Başlat

POST /api/interviews/:id/start ile AI sorularını hazırlayın (50 kredi)

5

WebSocket Bağlantısı

wss://interviewer.hiri.ai/ws/interview ile gerçek zamanlı mülakat yapın

6

Değerlendirme

AI otomatik değerlendirme ve puanlama yapar (3 kredi/soru)

7

Sonuçlar

GET /api/interviews/:id/result ile detaylı rapor alın

Conversation Transcript

Konuşma Kayıtları
Tüm mülakat konuşmaları otomatik olarak kaydedilir. Her mesaj, konuşan kişi (AI veya aday) ve zaman damgası ile birlikte saklanır. Bu kayıtlar mülakat analizi, kalite kontrolü ve uyumluluk için kullanılabilir.
GET /api/interviews/:id/transcript
Mülakat konuşma geçmişini görüntüleyin
curl https://interviewer.hiri.ai/api/interviews/789-interview-id/transcript \
  -H "X-API-Key: your-api-key-here"
Response 200 OK
{
  "interview_id": "789-interview-id",
  "candidate": {
    "name": "Ahmet Yılmaz",
    "email": "ahmet@example.com"
  },
  "position": {
    "title": "Senior Frontend Developer"
  },
  "messages": [
    {
      "id": "msg-1",
      "speaker": "ai",
      "message": "Merhaba, mülakatınıza hoş geldiniz...",
      "timestamp": "2025-10-25T10:35:00.000Z"
    },
    {
      "id": "msg-2",
      "speaker": "candidate",
      "message": "Merhaba, teşekkür ederim...",
      "timestamp": "2025-10-25T10:35:15.000Z"
    }
  ],
  "total_messages": 47
}

API Endpoints

Candidates

POST /api/candidates
GET /api/candidates
GET /api/candidates/:id

Positions

POST /api/positions
GET /api/positions
GET /api/positions/:id

Interviews

POST /api/interviews
POST /api/interviews/:id/start
POST /api/interviews/:id/complete
GET /api/interviews
GET /api/interviews/:id
GET /api/interviews/:id/result
GET /api/interviews/:id/transcript

Credits

GET /api/credits/balance
GET /api/credits/packages
POST /api/credits/purchase
GET /api/credits/transactions

Error Codes

400 Bad Request
Geçersiz istek veya eksik parametreler
401 Unauthorized
Geçersiz veya eksik API key / Admin key
402 Payment Required
Yetersiz kredi bakiyesi
404 Not Found
Kaynak bulunamadı
429 Too Many Requests
Rate limit aşıldı
500 Internal Server Error
Sunucu hatası

HireAI Interview Bot API

Profesyonel AI-Powered Interview Platform

Version 1.0.0 | Credit-Based Usage System