Açık API Arayüz Geliştirme Rehberi

Tüm arayüz istekleri URL'de aşağıdaki kimlik doğrulama parametrelerini içermelidir:

URL İstek Etme: /Code.ashx?op=code&app=api&token=YOUR_TOKEN&type=0

Çağrı yöntemi: POST

Parametreler URL'de eşit şekilde yazılır ve görüntü verileri POST gövdesinden geçirilir (çoklu bölüm desteklenir dosya akışı, form alanı veya düz metin).

2.1 Tanınacak görüntüyü girin (üçünden birini seçin)

2.2 Çekirdek mod ve motor kontrolü

2.3 Formatlama ve Düzen Kuralları (İstereğe Bağlı)

Aşağıdaki parametreler geçer değerleri 1 İlgili işlem değerini açın 0 Açık değil.
Özel bir ihtiyaç yoksa, bunu başkasına aktarmamanız ve karar sistemine bırakılması önerilir:

2.4 Dönüş Değeri Tanımı (JSON)

Tanıma arayüzü standart bir JSON formatı döndürür. Değeri şudur: null alan otomatik olarak atlanır.

Üst seviye alanlar

result Alt nesne – Metin sonucu

result Alt nesne - koordinat konumlandırma verileri 🗺️

Aşağıdaki alanlar, her metin bloğunun orijinal görüntüdeki kesin konumunu içerir; bu durum, üst katmanların vurgulanması, alan çıkarımı gibi senaryolar için uygundur.

verticalText TextCellInfo nesne yapısı

[
  {
    "words": "Tanınan metin içeriği",
    "trans": "Çeviri sonuçları (varsa)",
    "pageIndex": 0,
    "location": {
      "left": 120.0,
      "top": 45.0,
      "width": 230.0,
      "height": 28.0
    }
  },
  ...
]

result Alt nesne - Dosya indirme

files DownLoadInfo nesne yapısındaki DownLoadInfo nesne yapısı

state Durum sayımı

Arka örnek

✅ Başarılı yanıt (koordinat verileriyle birlikte):

{
  "ocrType": 0,
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "processId": 3,
  "processName": "OCR-Node-01",
  "state": 2,
  "result": {
    "autoText": "Akıllı birleştirmeden sonra tam metin",
    "spiltText": "Orijinal metin paragraflara bölünmüş",
    "verticalText": "[{\"words\":\"Merhaba\",\"location\":{\"left\":10,\"top\":20,\"width\":80,\"height\":22}}]",
    "resultType": 0,
    "lang": "chi_sim"
  }
}

❌ Hata/Limit Yanıtı:

{
  "ocrType": 0,
  "processName": "İpuçları",
  "result": {
    "spiltText": "Bugünkü API kotası tükendi, lütfen şarj edin ve kullanmaya devam edin！",
    "autoText": "Bugünkü API kotası tükendi, lütfen şarj edin ve kullanmaya devam edin！"
  },
  "id": 1
}

URL İstek Etme: /Code.ashx?op=idcode&app=api&token=YOUR_TOKEN

Çağrı yöntemi: POST

Fonksiyon: Tanıma arayüzüne göre döner id Asenkron işlem sonuçlarını sorgulayın. Tanıma arayüzü döndüğünde state=0(beklemede), bu arayüzü kullanarak anket yaparak nihai sonucu alabilirsiniz.

Arka örnek

✅ Başarılı Yanıt:

[
  {
    "ocrType": 0,
    "id": "a1b2c3d4-...",
    "processName": "OCR-Node-01",
    "state": 2,
    "result": {
      "autoText": "Ortaya çıkan metni tanımlayın",
      "spiltText": "Segmentli metin",
      "resultType": 0
    }
  }
]

❌ Yanıt başarısız (kimlik yok veya sonuç süresi dolmuş):

no

Düz metin döndürer no Bu kimlik için sonuç bulunmadığını gösterir, ki bu bir kimlik olabilir Hata veya sonuç süresi doldu ve temizlenir.

URL İstek Etme: /Code.ashx?op=imgUpload&app=api&token=YOUR_TOKEN

Çağrı yöntemi: POST (multipart/form-data)

Fonksiyon: Ücretsiz görsel yatağına bir görsel yükleyin ve kamu ağında erişilebilen doğrudan bir bağlantı URL'sini geri gönderin. Önce bir görüntü yüklemeniz ve ardından tanıma arayüzünü çağırmak için URL'yi kullanmanız gereken durumlar için uygundur.

Arka örnek

✅ Başarılı Yanıt:

https://cdn.example.com/uploads/abc123.jpg

❌ Başarısız yanıt (dosya yüklenmedi veya yükleme istisnası):

no

Düz metin döndürer no Dosyanın alınmadığını veya yükleme sürecinde bir istisna yaşandığını gösterir.

URL İstek Etme: /Code.aspx?op=count&app=api&token=YOUR_TOKEN

Çağrı yöntemi: GET

Bu arayüz üzerinden, tokenın bugün kaç kez kullanıldığını ve kalan kotayı görebilirsiniz.

Arka örnek

✅ Başarılı Yanıt:

{
  "Account": "api",
  "TodayCount": 52, // Bugün kullanılıyor"LimitCount": 9948       // Toplam akım sayısı
}

❌ Arıza yanıtı (geçersiz veya iletilmemiş token):

{
  "Account": "api",
  "TodayCount": 0,
  "LimitCount": 0
}

Not: Token geçersizse, hata bildirilmez, ancak LimitCount'un evet olup olmadığına bağlı olarak tüm 0 değerleriyle JSON döner Token'ın geçerliliğini değerlendirmek için 0.