Nyílt API interfész fejlesztési útmutató

Minden interfész kérésnek az alábbi hitelesítési paramétereket kell tartalmaznia az URL-ben:

URL kérés: /Code.ashx?op=code&app=api&token=YOUR_TOKEN&type=0

Hívás módszer: POST

A paraméterek egyenletesen vannak írva az URL-ben, és a képadatok áthaladnak a POST testen keresztül (többrészes támogatás is támogatott) fájl áramlása, űrlapmező vagy egyszerű szöveg).

2.1 Adja meg az ismerhető képet (válassz egyet a három közül)

2.2 Mag üzemmód és motorvezérlés

2.3 Formázás és elrendezési szabályok (opcionális)

Az alábbi paraméterek továbbítják az értékeket 1 Kapcsold be a megfelelő feldolgozási értéket 0 Nem kapcsolva.
Ha nincs konkrét szükség, ajánlott, hogy ne adjuk tovább, és a rendszer döntse el:

2.4 Visszatérítési érték leírása (JSON)

Az ismerő felület szabványos JSON formátumot ad vissza. Az érték a következőképpen null A mező automatikusan kihagyható.

Felső szintű mezők

result Alobjektum – Szöveg eredmény

result Al-objektum - koordináta pozicionálási adatok 🗺️

Az alábbi mezők minden szövegblokk pontos pozícióját az eredeti képen tartalmazzák, amelyek alkalmasak olyan helyzetekhez, mint a fedőrétegek kiemelése, területek kivonása stb.

verticalText TextCellInfo objektumszerkezet

[
  {
    "words": "A szöveg, amelyet felismernek",
    "trans": "Fordítási eredmények (ha vannak)",
    "pageIndex": 0,
    "location": {
      "left": 120.0,
      "top": 45.0,
      "width": 230.0,
      "height": 28.0
    }
  },
  ...
]

result Alobjektum - Fájlletöltés

files A DownLoadInfo objektumstruktúra a DownLoadInfo objektumstruktúrában

state Állami felsorolás

Vissza példa

✅ Sikeres válasz (koordinátaadatokkal):

{
  "ocrType": 0,
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "processId": 3,
  "processName": "OCR-Node-01",
  "state": 2,
  "result": {
    "autoText": "Teljes szöveg okos összevonás után",
    "spiltText": "Az eredeti szöveg bekezdésekre szegélyezve",
    "verticalText": "[{\"words\":\"Helló\",\"location\":{\"left\":10,\"top\":20,\"width\":80,\"height\":22}}]",
    "resultType": 0,
    "lang": "chi_sim"
  }
}

❌ Hiba/Limit válasz:

{
  "ocrType": 0,
  "processName": "Tippek",
  "result": {
    "spiltText": "A mai API kvóta kimerült, kérjük, töltsd fel és használd tovább！",
    "autoText": "A mai API kvóta kimerült, kérjük, töltsd fel és használd tovább！"
  },
  "id": 1
}

URL kérés: /Code.ashx?op=idcode&app=api&token=YOUR_TOKEN

Hívás módszer: POST

Funkció: A felismerő felület szerint visszaadva id Kérdezze az aszinkron feldolgozás eredményeit. Amikor a felismerő felület visszatér state=0(függőben), ezt a felületet használhatod a szavazáshoz, hogy megkapd a végső eredményt.

Vissza példa

✅ Sikeres válasz:

[
  {
    "ocrType": 0,
    "id": "a1b2c3d4-...",
    "processName": "OCR-Node-01",
    "state": 2,
    "result": {
      "autoText": "Azonosítsuk az eredményt",
      "spiltText": "Szegmentált szöveg",
      "resultType": 0
    }
  }
]

❌ Sikertelen válasz (azonosító nem létezik vagy az eredmény lejárt):

no

Egyszerű szöveget ad vissza no Ez azt jelzi, hogy nem találtak eredményt az adott azonosítóra, ami lehet azonosító A hiba vagy eredmény lejárt, és törölhető.

URL kérés: /Code.ashx?op=imgUpload&app=api&token=YOUR_TOKEN

Hívás módszer: POST (multipart/form-data)

Funkció: Tölts fel egy képet az ingyenes képágyra, és küldj vissza egy közvetlen link URL-t, amely elérhető a nyilvános hálózaton. Alkalmas olyan helyzetekre, amikor először fel kell tölteni egy képet, majd az URL-t kell használni az felismerő interfész meghívására.

Vissza példa

✅ Sikeres válasz:

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

❌ Sikertelen válasz (fájl nem feltöltés vagy feltöltési kivétel):

no

Egyszerű szöveget ad vissza no Ez azt jelzi, hogy a fájlt nem kapták meg, vagy kivétel történt a feltöltés során.

URL kérés: /Code.aspx?op=count&app=api&token=YOUR_TOKEN

Hívás módszer: GET

Ezen az interfészen keresztül megtekintheted, hányszor használták a tokent ma, és a fennmaradó kvótát.

Vissza példa

✅ Sikeres válasz:

{
  "Account": "api",
  "TodayCount": 52, // Ma használt"LimitCount": 9948       // Az áram fennmaradt összes száma
}

❌ Hiba válasz (érvénytelen vagy nem továbbított token):

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

Megjegyzés: Ha a token érvénytelen, nem jelentenek hiba, de a JSON minden értéke 0 lesz, attól függően, hogy a LimitCount igen-e vagy sem 0 a token érvényességének megítéléséhez.