API Başlangıç Rehberi

Cvisioner API, tRPC tabanlı, uçtan uca tip güvenliği sunan modern bir API'dir. Tüm uç noktalar https://api.cvisioner.com/v1 üzerinden erişilebilir durumdadır. Kimlik doğrulama Supabase Auth altyapısı üzerinden JWT bearer token'ları ile sağlanır.

Ön Koşullar

• Cvisioner işveren veya yönetici hesabı
• API anahtarı (aşağıda nasıl oluşturulacağı açıklanmıştır)
• HTTP istemcisi (curl, Postman, fetch vb.)

1. API Anahtarı Oluşturma

API anahtarınızı oluşturmak için:

1. Cvisioner Yönetim Paneli'ne giriş yapın
2. Ayarlar > API Anahtarları bölümüne gidin
3. Yeni Anahtar Oluştur butonuna tıklayın
4. Anahtarınıza bir isim verin ve izinleri seçin
5. Oluşturulan anahtarı güvenli bir yere kaydedin — anahtar yalnızca bir kez gösterilir

2. Base URL

Tüm API istekleri aşağıdaki base URL üzerinden yapılır:

https://api.cvisioner.com/v1

3. Kimlik Doğrulama

Her istekte Authorization başlığında JWT bearer token veya API anahtarı gönderilmelidir:

curl -X GET "https://api.cvisioner.com/v1/jobs.list" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Detaylı bilgi için Kimlik Doğrulama sayfasına bakın.

4. İlk İsteğiniz

Aşağıdaki örnekte aktif iş ilanlarını çekiyoruz:

curl -X GET "https://api.cvisioner.com/v1/jobs.list" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Başarılı yanıt:

{
  "result": {
    "data": [
      {
        "id": "job_abc123",
        "title": "Senior Frontend Developer",
        "company": "Acme Corp",
        "location": "İstanbul",
        "status": "published",
        "created_at": "2025-01-15T10:00:00Z"
      }
    ],
    "total": 42,
    "page": 1
  }
}

5. tRPC İstemcisi ile Kullanım

Eğer projeniz TypeScript tabanlıysa, tRPC istemcisi ile tip güvenli erişim sağlayabilirsiniz:

import { createTRPCClient, httpBatchLink } from "@trpc/client";
import type { AppRouter } from "@cvisioner/trpc";

const api = createTRPCClient<AppRouter>({
  links: [
    httpBatchLink({
      url: "https://api.cvisioner.com/v1",
      headers: () => ({
        Authorization: `Bearer ${process.env.CVISIONER_API_KEY}`,
      }),
    }),
  ],
});

const jobs = await api.jobs.list.query();

Rate Limiting

API istekleri aşağıdaki limitlerde sınırlandırılmıştır:

Limit aşıldığında 429 Too Many Requests yanıtı döner. Yanıt başlıklarındaki X-RateLimit-Remaining ve X-RateLimit-Reset değerlerini kontrol edin.

Sonraki Adımlar

• Kimlik Doğrulama — JWT ve API key detayları
• API Referansı — Tüm uç noktaların interaktif dokümantasyonu
• Webhook'lar — Gerçek zamanlı olay bildirimleri