API Dokümantasyonu

API anahtarınızı panelden alın

Pro veya İşletme planında Panel > API bölümünde anahtar oluşturabilirsiniz.

Kimlik doğrulama

Her isteğe Authorization: Bearer <API_ANAHTARI> başlığını ekleyin. Anahtarlar dk_live_ ile başlar. Taramalar planınızın kotasından düşülür ve panel geçmişinde "API" etiketiyle görünür. Hız sınırı: dakikada 120 istek.

Metin tespiti

POSThttps://demo.dedektor.ototeslimat.net/api/v1/text

curl -X POST https://demo.dedektor.ototeslimat.net/api/v1/text \
  -H "Authorization: Bearer dk_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"text": "Kontrol edilecek metin..."}'

Örnek yanıt:

{
  "ok": true,
  "result": {
    "id": 1842,
    "type": "text",
    "ai_probability": 87,
    "verdict": "ai_high",
    "verdict_label": "Büyük olasılıkla yapay zeka",
    "language": "Türkçe",
    "units": 214,
    "signals": [{ "label": "Kalıp ifadeler", "detail": "...", "weight": 1.8, "direction": "ai" }],
    "sentences": [{ "text": "Yapay zeka günümüzde...", "ai_probability": 91 }],
    "stats": { "words": 214, "sentences": 11, "avgSentence": 19.5, "burstiness": 0.21 }
  },
  "quota_left": { "words": 399786, "images": 500, "code_lines": 50000 }
}

Görsel tespiti

POSThttps://demo.dedektor.ototeslimat.net/api/v1/image Çok parçalı form (image alanı) ya da JSON {"image_base64": "...", "filename": "a.jpg"}. En fazla 10 MB.

curl -X POST https://demo.dedektor.ototeslimat.net/api/v1/image \
  -H "Authorization: Bearer dk_live_xxxxxxxx" \
  -F "image=@fotograf.jpg"

Yanıtta ai_probability, signals ve metadata (biçim, boyut, kamera, yazılım) alanları bulunur.

Kod tespiti

POSThttps://demo.dedektor.ototeslimat.net/api/v1/code language isteğe bağlıdır: python, csharp, vbnet, cpp, java, javascript, typescript, php, go, rust, sql, html. Boş bırakılırsa dil otomatik algılanır.

import requests

r = requests.post(
    "https://demo.dedektor.ototeslimat.net/api/v1/code",
    headers={"Authorization": "Bearer dk_live_xxxxxxxx"},
    json={"code": open("odev.py").read(), "language": "python"},
)
sonuc = r.json()["result"]
print(sonuc["ai_probability"], sonuc["verdict_label"])
for satir in sonuc["flagged_lines"]:
    print(satir["line"], satir["reason"])

C# (Visual Studio) örneği:

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer dk_live_xxxxxxxx");
var body = new StringContent(JsonSerializer.Serialize(new { code = File.ReadAllText("Program.cs") }), Encoding.UTF8, "application/json");
var res = await http.PostAsync("https://demo.dedektor.ototeslimat.net/api/v1/code", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());

Kullanım ve kota

GEThttps://demo.dedektor.ototeslimat.net/api/v1/usage Planınızı, kalan kotalarınızı ve sıfırlanma tarihini döndürür.

Hata kodları

Kod	Anlamı
400	Eksik veya geçersiz içerik (ör. 15 kelimeden kısa metin)
401	API anahtarı yok ya da geçersiz
402	Kota yetersiz ya da tarama başına sınır aşıldı
403	Planınızda API erişimi yok
413	Metin, kod ya da görsel çok büyük
429	Hız sınırı aşıldı; `Retry-After` başlığındaki süre kadar bekleyin