API Dokümantasyonu

Özetleme hattının veri işleme ve güvenlik sözleşmesi.

Bu doküman, Katipözet içindeki özetleme akışının teknik davranışını açıklar. Buradaki maddeler tanıtım kopyası değil, uygulamadaki istek sözleşmesi ve veri işleme yaklaşımının özetidir.

1. POST /api/summarize

Özetleme uç noktası, aktif kullanıcı oturumu ve same-origin isteği gerektirir. İstek gövdesi JSON biçiminde kabul edilir.

inputMode: text veya pdf
text: Düz metin girişi kullanıldığında zorunlu içerik
fileData: PDF modunda base64 gövde
scope: flash, kisa, standart, detayli, kapsamli
docType: Belge türü yönlendirmesi veya otomatik
anonymize: Varsayılan true, kişisel veri maskesini etkin tutar

2. Yanıt Sözleşmesi

Başarılı isteklerde yapılandırılmış JSON yanıtı döner. Hata halinde errorCode alanı ile istemci akışı kontrol edilebilir.

summary: Tek parça özet metni
keywords: En fazla 7 anahtar kelime
detectedDocType: dava, cevap, talep, bilirkisi, diger
success: İşlem sonucu
error ve errorCode: Başarısız isteklerde hata alanları

3. Hata Kodları

UNAUTHORIZED: Geçerli oturum yok
FORBIDDEN: Origin doğrulaması başarısız
BAD_REQUEST: Gövde alanları geçersiz
PAYLOAD_TOO_LARGE: İstek gövdesi boyut sınırını aştı
TEXT_TOO_LONG: Metin uzunluğu sınırı aşıldı
RATE_LIMIT: Kullanıcı başına 15 saniyelik özet aralığı dolmadı
SUMMARIZE_FAILED: Dış model veya işleme hattı tamamlanamadı

4. Veri İşleme ve Güvenlik Maddeleri

Ham belge içeriği uygulama tarafından kalıcı dosya alanına yazılmaz; işlem, istek yaşam döngüsü içinde tamamlanır.
Anonimleştirme açıkken isim, TC kimlik numarası, telefon, e-posta, IBAN ve benzeri alanlar yer tutucularla maskelenir.
Özet üretimi için yapılandırılmış model sağlayıcısına ham kimlik verisi yerine mümkün olduğunda maskelenmiş içerik gönderilir.
Kullanım günlüklerinde tam belge metni saklanmaz; yalnızca karakter sayısı, sayfa sayısı, belge türü, süre ve başarı durumu gibi meta veriler tutulur.
API yanıtları no-store başlıklarıyla döner; tarayıcı ve ara katman önbelleklerinde kalıcı içerik bırakmaması hedeflenir.
İstekler yalnızca same-origin denetimini geçen ve aktif oturumu olan kullanıcılar için kabul edilir.

5. Limitler

Metin boyutu: 50.000 karaktere kadar
İstek limiti: 1 istek / 15 saniye

1. POST /api/summarize

Özetleme uç noktası, aktif kullanıcı oturumu ve same-origin isteği gerektirir. İstek gövdesi JSON biçiminde kabul edilir.

inputMode: text veya pdf

text: Düz metin girişi kullanıldığında zorunlu içerik

fileData: PDF modunda base64 gövde

scope: flash, kisa, standart, detayli, kapsamli

docType: Belge türü yönlendirmesi veya otomatik

anonymize: Varsayılan true, kişisel veri maskesini etkin tutar

2. Yanıt Sözleşmesi

Başarılı isteklerde yapılandırılmış JSON yanıtı döner. Hata halinde errorCode alanı ile istemci akışı kontrol edilebilir.

summary: Tek parça özet metni

keywords: En fazla 7 anahtar kelime

detectedDocType: dava, cevap, talep, bilirkisi, diger

success: İşlem sonucu

error ve errorCode: Başarısız isteklerde hata alanları

3. Hata Kodları

UNAUTHORIZED: Geçerli oturum yok

FORBIDDEN: Origin doğrulaması başarısız

BAD_REQUEST: Gövde alanları geçersiz

PAYLOAD_TOO_LARGE: İstek gövdesi boyut sınırını aştı

TEXT_TOO_LONG: Metin uzunluğu sınırı aşıldı

RATE_LIMIT: Kullanıcı başına 15 saniyelik özet aralığı dolmadı

SUMMARIZE_FAILED: Dış model veya işleme hattı tamamlanamadı

4. Veri İşleme ve Güvenlik Maddeleri

Ham belge içeriği uygulama tarafından kalıcı dosya alanına yazılmaz; işlem, istek yaşam döngüsü içinde tamamlanır.

Anonimleştirme açıkken isim, TC kimlik numarası, telefon, e-posta, IBAN ve benzeri alanlar yer tutucularla maskelenir.

Özet üretimi için yapılandırılmış model sağlayıcısına ham kimlik verisi yerine mümkün olduğunda maskelenmiş içerik gönderilir.

Kullanım günlüklerinde tam belge metni saklanmaz; yalnızca karakter sayısı, sayfa sayısı, belge türü, süre ve başarı durumu gibi meta veriler tutulur.

API yanıtları no-store başlıklarıyla döner; tarayıcı ve ara katman önbelleklerinde kalıcı içerik bırakmaması hedeflenir.

İstekler yalnızca same-origin denetimini geçen ve aktif oturumu olan kullanıcılar için kabul edilir.