Gabay sa Pag-unlad ng Interface ng API

Ang lahat ng mga kahilingan sa interface ay dapat isama ang mga sumusunod na parameter ng pagpapatunay sa URL:

Email Address *: /Code.ashx?op=code&app=api&token=YOUR_TOKEN&type=0

Paraan ng pagtawag: POST

Ang mga parameter ay pare-pareho ang spelling sa URL, at ang data ng imahe ay ipinapasa sa pamamagitan ng katawan ng POST (suportado ang multipart daloy ng file, form field, o plain text).

2.1 Ipasok ang imahe na makikilala (pumili ng isa sa tatlo)

2.2 Core mode at kontrol ng engine

2.3 Mga Panuntunan sa Pag-format at Layout (Opsyonal)

Ang mga sumusunod na parameter ay pumasa sa mga halaga 1 I-on ang kaukulang pagproseso, halaga 0 Hindi sa.
Kung walang partikular na pangangailangan, inirerekumenda na huwag itong ipasa at ipaubaya ito sa sistema upang magpasya:

2.4 Paglalarawan ng Return Value (JSON)

Ang interface ng pagkilala ay nagbabalik ng isang karaniwang format ng JSON. Ang halaga ay null Awtomatikong tinanggal ang field.

Mga patlang sa itaas na antas

result Sub-object – Resulta ng teksto

result Sub-object - coordinate ng data ng pagpoposisyon 🗺️

Ang mga sumusunod na patlang ay naglalaman ng eksaktong posisyon ng bawat bloke ng teksto sa orihinal na imahe, na angkop para sa mga sitwasyon tulad ng pag-highlight ng mga overlay, pagkuha ng lugar, atbp.

verticalText Istraktura ng object ng TextCellInfo

[
  {
    "words": "Ang nilalaman ng teksto na kinikilala",
    "trans": "Mga resulta ng pagsasalin (kung mayroon man)",
    "pageIndex": 0,
    "location": {
      "left": 120.0,
      "top": 45.0,
      "width": 230.0,
      "height": 28.0
    }
  },
  ...
]

result Sub-object - Pag-download ng file

files Ang istraktura ng object ng DownLoadInfo sa istraktura ng object ng DownLoadInfo

state Enumerasyon ng estado

Bumalik halimbawa

✅ Matagumpay na tugon (na may coordinate data):

{
  "ocrType": 0,
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "processId": 3,
  "processName": "OCR-Node-01",
  "state": 2,
  "result": {
    "autoText": "Kumpletuhin ang teksto pagkatapos ng matalinong pagsamahin",
    "spiltText": "Orihinal na teksto na hinati sa mga talata",
    "verticalText": "[{\"words\":\"Hello\",\"location\":{\"left\":10,\"top\":20,\"width\":80,\"height\":22}}]",
    "resultType": 0,
    "lang": "chi_sim"
  }
}

❌ Error / Limitasyon ng Tugon:

{
  "ocrType": 0,
  "processName": "Mga Tip",
  "result": {
    "spiltText": "Naubos na ang quota ng API ngayon, mangyaring mag-recharge at ipagpatuloy ang paggamit nito！",
    "autoText": "Naubos na ang quota ng API ngayon, mangyaring mag-recharge at ipagpatuloy ang paggamit nito！"
  },
  "id": 1
}

Email Address *: /Code.ashx?op=idcode&app=api&token=YOUR_TOKEN

Paraan ng pagtawag: POST

Pag-andar: Ibinalik ayon sa interface ng pagkilala id I-click ang Mga Resulta ng Asynchronous Processing. Kapag bumalik ang interface ng pagkilala state=0(Hinihintay), maaari mong gamitin ang interface na ito upang botohan upang makuha ang pangwakas na resulta.

Bumalik halimbawa

✅ Matagumpay na Tugon:

[
  {
    "ocrType": 0,
    "id": "a1b2c3d4-...",
    "processName": "OCR-Node-01",
    "state": 2,
    "result": {
      "autoText": "Tukuyin ang nagresultang teksto",
      "spiltText": "Email Address *",
      "resultType": 0
    }
  }
]

❌ Nabigong tugon (hindi umiiral ang ID o nag-expire na ang resulta):

no

Ibinabalik ang plain text no Ipinapahiwatig na walang natagpuan na resulta para sa ID na iyon, na maaaring isang ID Ang error o resulta ay nag-expire na at na-clear.

Email Address *: /Code.ashx?op=imgUpload&app=api&token=YOUR_TOKEN

Paraan ng pagtawag: POST (multipart/form-data)

Pag-andar: Mag-upload ng isang imahe sa libreng kama ng imahe at ibalik ang isang direktang link URL na naa-access sa pampublikong network. Ito ay angkop para sa mga sitwasyon kung saan kailangan mong mag-upload ng isang imahe muna at pagkatapos ay gamitin ang URL upang tawagan ang interface ng pagkilala.

Bumalik halimbawa

✅ Matagumpay na Tugon:

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

❌ Nabigong tugon (hindi na-upload ang file o pagbubukod sa pag-upload):

no

Ibinabalik ang plain text no Ipinapahiwatig na ang file ay hindi natanggap o isang pagbubukod na naganap sa panahon ng proseso ng pag-upload.

Email Address *: /Code.aspx?op=count&app=api&token=YOUR_TOKEN

Paraan ng pagtawag: GET

Sa pamamagitan ng interface na ito, maaari mong tingnan ang bilang ng mga beses na ginamit ang token ngayon at ang natitirang quota.

Bumalik halimbawa

✅ Matagumpay na Tugon:

{
  "Account": "api",
  "TodayCount": 52, // Ginamit ngayon"LimitCount": 9948       // Ang kabuuang bilang ng mga ito ay nananatiling
}

❌ Tugon sa pagkabigo (hindi wasto o hindi ipinadala na token):

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

Tandaan: Kung ang token ay hindi wasto, walang error ang iuulat, ngunit ibabalik ang JSON na may lahat ng mga halaga ng 0, depende sa kung ang LimitCount ay oo o hindi 0 Upang hatulan ang bisa ng token.