API Dokümantasyonu

AI destekli belge analiz servisi. Fiş, fatura, dekont ve diğer belgeleri analiz eder.

Sistem

Servis durumunu kontrol eder
Response Type application/json
JSON formatında servis durum bilgisi
Response Örneği (200 OK)
{ "status": "ok", "message": "API is running" }
cURL Örneği
curl -X GET "{{BASE_URL}}/api/health"

Belge Analiz

Resim analizi - Fiş, fatura, dekont gibi resim belgelerini analiz eder
file multipart/form-data
Gerekli. Analiz edilecek resim dosyası (JPG, PNG, GIF, BMP, WEBP). Maksimum boyut: 10MB
Response Type application/json
JSON formatında analiz sonucu ve çıkarılan bilgiler
Response Örneği (200 OK)
{ "success": true, "data": { "document_type": "FİŞ", "confidence_score": 0.95, "source_type": "IMAGE", "business_info": { "name": "Örnek Market", "address": "Örnek Mahalle, Örnek Sokak No:1", "phone": "0212 123 45 67", "tax_number": "1234567890", "tax_office": "Kadıköy" }, "transaction_info": { "date": "2024-01-15", "time": "14:30", "document_number": "FİŞ-001234", "payment_method": "Nakit" }, "items": [ { "name": "Ekmek", "quantity": 2, "unit_price": "5.00 TL", "total_price": "10.00 TL" } ], "totals": { "subtotal": "35.00 TL", "grand_total": "35.35 TL" }, "extracted_text": "Belgeden çıkarılan ham metin..." } }
cURL Örneği
curl -X POST "{{BASE_URL}}/api/analyze/image" \ -F "file=@receipt.jpg"
PDF analizi - PDF formatındaki belgeleri analiz eder
file multipart/form-data
Gerekli. Analiz edilecek PDF dosyası. Maksimum boyut: 20MB
Response Type application/json
JSON formatında analiz sonucu ve çıkarılan bilgiler
Response Örneği (200 OK)
{ "success": true, "data": { "document_type": "FATURA", "confidence_score": 0.92, "source_type": "PDF", "business_info": { "name": "Örnek Şirket", "address": "Örnek Mahalle, Örnek Sokak No:1", "phone": "0212 123 45 67", "tax_number": "1234567890" }, "transaction_info": { "date": "2024-01-15", "document_number": "FAT-001234" }, "items": [ { "name": "Ürün Adı", "quantity": 1, "unit_price": "100.00 TL", "total_price": "100.00 TL" } ], "totals": { "grand_total": "118.00 TL" }, "extracted_text": "Belgeden çıkarılan ham metin...", "page_count": 1 } }
cURL Örneği
curl -X POST "{{BASE_URL}}/api/analyze/pdf" \ -F "file=@invoice.pdf"

CV Analiz

CV analizi - PDF formatındaki CV (özgeçmiş) belgelerini analiz eder
file multipart/form-data
Gerekli. Analiz edilecek CV PDF dosyası. Maksimum boyut: 20MB
Response Type application/json
JSON formatında CV analiz sonucu ve çıkarılan bilgiler
Response Örneği (200 OK)
{ "success": true, "data": { "source_type": "PDF", "confidence_score": 0.98, "personal_info": { "full_name": "Ahmet Yılmaz", "email": "ahmet@example.com", "phone": "+90 555 123 45 67" }, "education": [ { "degree": "Lisans", "institution": "İTÜ", "field_of_study": "Bilgisayar Mühendisliği" } ], "work_experience": [ { "position": "Senior Software Engineer", "company": "Tech Company", "start_date": "2020-01", "end_date": "2024-12" } ], "extracted_text": "CV'den çıkarılan ham metin...", "page_count": 1 } }
cURL Örneği
curl -X POST "{{BASE_URL}}/api/analyze/cv" \ -F "file=@cv.pdf"

Kartvizit Analiz

Kartvizit analizi - Kartvizit resimlerini analiz eder ve iletişim bilgilerini çıkarır
file multipart/form-data
Gerekli. Analiz edilecek kartvizit resim dosyası (JPG, PNG, GIF, BMP, WEBP). Maksimum boyut: 10MB
Response Type application/json
JSON formatında kartvizit analiz sonucu ve çıkarılan bilgiler
Response Örneği (200 OK)
{ "success": true, "data": { "source_type": "IMAGE", "confidence_score": 0.95, "person_name": "Ahmet Yılmaz", "title": "Senior Software Engineer", "company_name": "Tech Solutions A.Ş.", "company_abbreviation": "TS", "phones": [ { "type": "mobile", "number": "+90 555 123 45 67" }, { "type": "work", "number": "+90 212 555 12 34" } ], "emails": [ { "address": "ahmet.yilmaz@techsolutions.com" } ], "address": { "full_address": "Maslak Mahallesi, Büyükdere Cad. No:123, Sarıyer, İstanbul, Türkiye", "street": "Büyükdere Cad.", "building_number": "No:123", "district": "Maslak Mahallesi", "city": "İstanbul", "country": "Türkiye", "postal_code": "34398" }, "website": "www.techsolutions.com", "social_media": { "linkedin": "linkedin.com/in/ahmetyilmaz", "twitter": "twitter.com/ahmetyilmaz" }, "additional_info": { "colors": "Mavi, Beyaz", "other_text": "24/7 Destek" }, "extracted_text": "Kartvizitten çıkarılan ham metin..." } }
cURL Örneği
curl -X POST "{{BASE_URL}}/api/analyze/business-card" \ -F "file=@business-card.jpg"