Soru bankası API'si

Nasıl çalışır

1. 01

   Hesap açın ve anahtarınızı alın

   Hesap panelindeki API sayfasında API Kullanım Sözleşmesi'ni onaylayıp anahtar üretirsiniz. Anahtar yalnızca bir kez gösterilir, sistemde özeti saklanır. İsteklerde X-API-Key başlığıyla ya da Authorization: Bearer olarak gönderilir.

2. 02

   Kataloğa ve stoğa bakın

   GET /v1/catalog/exams, /catalog/subjects ve /catalog/topics uçları sınavları, dersleri ve konuları güncel soru sayılarıyla listeler. POST /v1/questions/availability bir siparişten önce stoğu sorar; kredi ve kota harcamaz.

3. 03

   Siparişinizi verin

   POST /v1/questions/draw isteğinde sınavı yazar, soru sayısını toplam olarak (count) ya da konu konu dağılım olarak (blueprint) verirsiniz. Zorluk 1 ile 5 arasında bir hedeftir: önce o zorluğa en yakın sorular seçilir.

4. 04

   Sorular yanıtta gelir

   Her soru kök, şıklar, doğru cevap, çözüm, kazanım bilgisi ve anahtar kelimelerle gelir. Teslim aldığınız bir soruyu daha sonra GET /v1/questions/{id} ile ücretsiz yeniden okuyabilirsiniz.

Örnek istek

Aşağıdaki istek LGS Matematik'ten, orta zorluğu hedefleyen 15 soru ister: 10'u Çarpanlar ve Katlar, 5'i Oran ve Orantı konusundan. Idempotency-Key başlığı, bağlantı koptuğunda aynı isteği yeniden gönderirseniz ikinci kez ücretlendirilmemenizi sağlar: sistem aynı soruları yeni teslimat yazmadan yeniden döndürür.

POST https://api.logaritim.com/v1/questions/draw
X-API-Key: qg_live_...
Idempotency-Key: siparis-2026-10-12-001
Content-Type: application/json

{
  "exam": "LGS",
  "subject": "Matematik",
  "difficulty": 3,
  "blueprint": [
    { "topic": "Çarpanlar ve Katlar", "count": 10 },
    { "topic": "Oran ve Orantı", "count": 5 }
  ],
  "exclude_delivered": true
}

Yanıt

Yanıtta istenen ve teslim edilen soru sayısı, harcanan kredi ve kalan bakiye yer alır. Bir konuda yeterli soru yoksa eksik kalan kısım shortfall alanında konu konu ve nedeniyle bildirilir; o kısım için kredi düşmez.

{
  "delivery_id": "8f3c…",
  "requested": 15,
  "delivered": 15,
  "replayed": false,
  "credits": { "cost": 15, "balance": 35 },
  "shortfall": [],
  "questions": [
    {
      "id": "4538015e…",
      "exam": "LGS",
      "subject": "Matematik",
      "topic": "Çarpanlar ve Katlar",
      "difficulty": 3,
      "stem": "24 sayısının pozitif tam bölen…",
      "options": [ { "letter": "A", "text": "6" }, … ],
      "answer": { "index": 2, "letter": "C" },
      "explanation": "…"
    }
  ]
}

Kredi ve fiyat

API ile hesap panelindeki sınav hazırlama aynı kredi bakiyesini kullanır. API üzerinden gelen her soru 1 kredi; kredi yalnızca soru API hesabınıza ilk kez teslim edildiğinde düşer. Aynı isteğin tekrarı, stok sorgusu ve teslim aldığınız soruyu yeniden okumak ücretsizdir.

Yeni hesaplara 50 kredi hediye tanımlanıyor; API'yi denemek için bu yeterli. Kredi paketleri ve güncel fiyatlar hesap panelinde. Ödeme havale ya da EFT ile yapılıyor ve onaylandığında bakiyeye ekleniyor.

Sınırlar

Daha yüksek bir sınıra ihtiyacınız varsa iletişim kanallarımızdan bize yazın.

• Kredi bakiyesi varken ayda 5.000 yeni soru, dakikada 60 istek ve istek başına en fazla 25 soru.
• Aylık kota, o ay API hesabınıza ilk kez teslim edilen soruları sayar ve her ayın 1'inde sıfırlanır.
• Bakiye sıfırken katalog ve stok uçları çalışır; soru çekmek kredi gerektirir.
• Her yanıtta X-RateLimit-Limit ve X-RateLimit-Remaining başlıkları gelir; sınır aşılınca 429 ve Retry-After döner.

Hangi sorular geliyor

API, hesabınıza açık olan onaylı havuzdan seçim yapar: 6., 7., 9., 10. ve 11. sınıf okul dersleri; LGS, TYT, AYT, KPSS, ALES ve DGS; YDS, YDT ve YÖKDİL gibi dil sınavları. Hangi sınavda hangi dersin ve konunun kaç sorusu olduğunu katalog uçları anlık olarak verir.

API şu an yalnızca görselsiz soruları teslim ediyor. Grafik, şekil ya da tablo içeren sorular hesap panelinden hazırlanan PDF sınavlarda kullanılabiliyor.

Teslimat defteri: varsayılan olarak aynı API hesabına daha önce teslim edilmiş bir soru yeniden gelmez. İsterseniz exclude_delivered alanıyla kapatabilirsiniz; yeniden gelen soru ücretlendirilmez.

Sık karşılaşılan yanıt kodları

Hatalar her zaman aynı zarfla döner: error.code, error.message ve isteği izlemek için request_id.

• 401: anahtar yok ya da geçersiz.
• 402: kredi bakiyesi yetersiz.
• 404: bilinmeyen sınav ya da ders; yanıt geçerli değerlerin listesini de içerir.
• 409: aynı Idempotency-Key farklı bir istek gövdesiyle kullanıldı.
• 429: aylık kota ya da dakikalık istek sınırı aşıldı.