API Dokümantasyonu

QuantumLab Pro REST API ile quantum simülasyonları çalıştırın

Base URL: https://quantum.spiron.io/api

Genel Bakış

QuantumLab Pro API, quantum devre simülasyonları çalıştırmanızı, eğitim içeriklerine erişmenizi ve ilerlemenizi takip etmenizi sağlar.

Tüm API istekleri JSON formatında veri alır ve döner. Kimlik doğrulama gerektiren endpoint'ler için Authorization header'ında Bearer token göndermeniz gerekir.

Kimlik Doğrulama

API, JWT (JSON Web Token) tabanlı kimlik doğrulama kullanır. Token'ı login endpoint'inden alabilirsiniz.

Header 
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Token 24 saat geçerlidir. Süresi dolan token ile istek yapıldığında 401 hatası alırsınız.

Hata Kodları

Kod Açıklama
400 Geçersiz istek parametreleri
401 Kimlik doğrulama gerekli veya token geçersiz
404 Kaynak bulunamadı
500 Sunucu hatası

Auth API

POST /auth/register

Yeni kullanıcı hesabı oluşturur.

Request Body

Parametre Tip Açıklama
email * string E-posta adresi
password * string Şifre (min 8 karakter)
full_name * string Ad soyad
kvkk_consent * boolean KVKK onayı (true olmalı)

Örnek Response

200 OK
{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "bearer",
  "user": {
    "id": "user-123",
    "email": "user@example.com",
    "full_name": "John Doe",
    "role": "student"
  }
}
POST /auth/login

Mevcut hesaba giriş yapar ve token döner.

Request Body (form-data)

Parametre Tip Açıklama
username * string E-posta adresi
password * string Şifre
GET /auth/me

Giriş yapmış kullanıcının bilgilerini döner. Auth Required

Lessons API

GET /lessons

Tüm dersleri listeler. Giriş yapılmışsa ilerleme bilgisi de döner.

Örnek Response

200 OK
{
  "success": true,
  "lessons": [
    {
      "id": 1,
      "title": "Qubit Nedir?",
      "module": "Temel Kavramlar",
      "difficulty": "beginner",
      "duration": 45,
      "progress_percent": 100,
      "status": "completed"
    }
  ]
}
GET /lessons/{lesson_id}

Belirli bir dersin detaylarını döner.

POST /lessons/progress

Ders ilerleme durumunu günceller. Auth Required

Request Body

Parametre Tip Açıklama
lesson_id integer Ders ID
progress_percent integer İlerleme yüzdesi (0-100)

Simulation API

POST /simulate

Quantum devre simülasyonu çalıştırır.

Request Body

Parametre Tip Açıklama
num_qubits integer Qubit sayısı (1-10)
num_gates integer Kapı sayısı
algorithm string Algoritma: bell, ghz, qft, grover, teleportation
shots integer Ölçüm sayısı (default: 1024)

Örnek Response

200 OK
{
  "success": true,
  "data": {
    "measurements": {"00": 512, "11": 512},
    "circuit_depth": 3,
    "operations": [...],
    "execution_time": 0.045
  }
}

Certificates API

GET /certificates/verify/{code}

Sertifika kodunu doğrular.

Path Parameters

Parametre Tip Açıklama
code string Sertifika doğrulama kodu

Örnek Response

200 OK
{
  "valid": true,
  "certificate": {
    "holder_name": "John Doe",
    "course": "Quantum Computing Temelleri",
    "issue_date": "2025-02-01",
    "certificate_id": "QLP-2025-001234"
  }
}