{"openapi":"3.1.0","info":{"title":"CSP API","version":"4.1.0","description":"Banka dekontu PDF'lerinin orijinal olup olmadığını çok katmanlı adli analizle tespit eder. Türkçe doküman: /docs"},"servers":[{"url":"/"}],"tags":[{"name":"Analiz"},{"name":"Hesap"},{"name":"Bankalar"}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Error":{"type":"object","properties":{"detail":{"type":"string"}}},"Finding":{"type":"object","properties":{"code":{"type":"string"},"severity":{"enum":["info","low","medium","high","critical"]},"weight":{"type":"integer"},"category":{"type":"string"},"message":{"type":"string"}}},"Analysis":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string"},"filename":{"type":"string"},"sha256":{"type":"string"},"verdict":{"type":"string"},"verdict_code":{"enum":["original","suspicious","forged"]},"risk_score":{"type":"integer","minimum":0,"maximum":100},"confidence":{"enum":["yüksek","orta","düşük"]},"summary":{"type":"string"},"bank":{"type":["string","null"]},"findings":{"type":"array","items":{"$ref":"#/components/schemas/Finding"}},"evidence":{"type":"array","items":{"type":"string"}},"fields":{"type":"object","properties":{"sender":{"type":"string"},"receiver":{"type":"string"},"amount":{"type":["object","null"],"properties":{"value":{"type":"number"},"currency":{"type":"string"},"text":{"type":"string"}}},"amount_in_words":{"type":"array","items":{"type":"string"}},"transaction_date":{"type":"string"},"ibans":{"type":"array","items":{"type":"object","properties":{"iban":{"type":"string"},"valid":{"type":"boolean"},"bank":{"type":["string","null"]}}}},"references":{"type":"array","items":{"type":"string"}},"description":{"type":"string"}}},"categories":{"type":"object"},"metadata":{"type":"object"},"structure":{"type":"object"},"signatures":{"type":"array"},"duplicate":{"type":"object"}}}}},"paths":{"/api/v1/health":{"get":{"tags":["Analiz"],"summary":"Servis durumu","responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/analyze":{"post":{"tags":["Analiz"],"summary":"Dekont analiz et (multipart)","description":"İzin: **analyze**","security":[{"ApiKey":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Analysis"}}}},"401":{"description":"Anahtar geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"İzin/IP","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Dosya büyük","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Hız sınırı / kota","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/analyze/base64":{"post":{"tags":["Analiz"],"summary":"Dekont analiz et (JSON + base64)","description":"İzin: **analyze**","security":[{"ApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["file_base64"],"properties":{"file_base64":{"type":"string"},"filename":{"type":"string","default":"dekont.pdf"}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Analysis"}}}},"400":{"description":"Geçersiz base64","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/analyses":{"get":{"tags":["Hesap"],"summary":"Analiz geçmişi","description":"İzin: **read**","security":[{"ApiKey":[]}],"parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"size","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"verdict","in":"query","schema":{"enum":["original","suspicious","forged"]}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/analyses/{id}":{"get":{"tags":["Hesap"],"summary":"Önceki analizi getir","description":"İzin: **read**","security":[{"ApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Analysis"}}}},"404":{"description":"Bulunamadı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/me":{"get":{"tags":["Hesap"],"summary":"Anahtar, izinler ve kota","description":"İzin: **read**","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/banks":{"get":{"tags":["Bankalar"],"summary":"Bankalar ve öğretilmiş örnek sayıları","description":"İzin: **banks**","security":[{"ApiKey":[]}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"array"}}}}}}}}}