API Dokümantasyonu

OCRTurk API ile uygulamalarınıza gelişmiş metin tanıma özellikleri ekleyin. Basit HTTP istekleri ile görsellerden metin çıkarın.

API Erişimi İsteyin

API anahtarı almak ve limitler hakkında bilgi için bizimle iletişime geçin.

Müşteri Panelinden İşlem Yapın

Yetkilendirme

Tüm API isteklerinde yetkilendirme zorunludur. Size özel olarak tanımlanan API anahtarını X-API-KEY header'ında veya key query parametresinde göndermelisiniz.

Örnek Header Kullanımı

X-API-KEY: YOUR_API_KEY

Resim Yükleme (Upload)

Bir resim dosyası yükleyerek OCR işlemi başlatın.

POST /api/index.php?action=upload

Parametre	Tip	Zorunlu	Açıklama
file	File	EVET	İşlenecek resim dosyası (JPG, PNG, WEBP). Max 10MB.
engine	String	HAYIR	OCR motoru seçimi. Seçenekler: ai, turkce veya advanced_tr. Varsayılan: ai

cURL Örneği

curl -X POST "https://ocrturk.com/api/index.php?action=upload" \
  -H "X-API-KEY: API_KEYINIZ" \
  -F "file=@belge.jpg" \
  -F "engine=ai"

Başarılı Yanıt

{
  "success": true,
  "text": "Belgedeki metin buraya gelir...",
  "lines": ["Satır 1", "Satır 2"]
}

Base64 ile OCR

Base64 kodlanmış resim verisi ile OCR işlemi başlatın.

POST /api/index.php?action=ocr

JSON Body

{
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
  "engine": "turkce"
}

Hata Kodları

Kod	Açıklama
200	İşlem başarılı
400	Hatalı istek (Dosya formatı, boyutu vb.)
401	API anahtarı eksik
403	Geçersiz veya pasif API anahtarı