Bevezetés

RESTful API-kat biztosít dokumentumfordításhoz, támogatva az automatizált fordítási feladatok kezelését, szószedet-alapú terminológiai konzisztenciát, valamint a támogatott formátumok, nyelvek és modellek lekérdezését, megkönnyítve a zökkenőmentes fordítási munkafolyamatok kialakítását és a felhasználói fiókok kezelését.

Kezdő lépések

A kezdéshez fejlesztői jogosultságra kell jelentkeznie.Jelentkezés fejlesztőként

Jóváhagyás után több API kulcsot is létrehozhat, és szükség szerint beillesztheti a megfelelő API kulcsot minden egyes API kérésbe.

API kulcs beszerzése

Gyors hozzáférés

Base URL

https://otranslator.com/api

Hitelesítési módszer

Authorization: [yourSecretKey]

JSON kérés

A fájlfeltöltési végponton kívül a végpontok alapértelmezés szerint POST JSON kérést használnak, a Content-Type application/json.

Fájlfeltöltés

A dokumentumfordítási feladat létrehozása multipart/form-data formátumot használ, a file mezőben kell átadni a lefordítandó fájlt.

Általános hibaválasz

Sikertelen kérés esetén az interfész JSON-t ad vissza, az error mező rögzített angol nyelvű hibaüzenetet tartalmaz. Javasolt elsősorban a HTTP status code alapján kezelni a hibákat, az error mező megjelenítésre vagy naplózásra használható.

{
  "error": "Invalid API key."
}

Hiba állapotkód szabály

Minden v1 API hibaválasz azonos struktúrájú, kérjük, az alábbi HTTP status code szabályok szerint kezelje.

400 Bad Request: Missing required parameters, invalid parameter formats or enum values, missing file upload, upload save failure, or task processing failure.
401 Unauthorized: Missing API key or invalid API key.
402 Payment Required: Insufficient credits balance for preview, full translation, or text translation.
404 Not Found: The task or glossary does not exist, has been deleted, does not belong to the current API account, or was not created through the API.
409 Conflict: The current task status does not allow the requested operation.
500 Internal Server Error: Unexpected server exception. The response error is fixed as "Internal server error.".

Ajánlott bevezetési folyamat

1. Feladat létrehozása

Fájl feltöltése és fordítási feladat létrehozása, taskId visszaadása.

2. Előrehaladás lekérdezése

A feladat állapotának lekérdezése, amíg Completed, Terminated vagy Cancelled állapotba nem kerül.

3. Eredmény lekérése

Lefordított fájl letöltése, vagy az eredeti és lefordított JSON olvasása.

4. Feladatok kezelése

Használatalapú fizetés teljes szöveges fordításért, feladat újraindításáért, szöveg módosításáért vagy feladat törléséért.

Erőforrások

Fejlesztői közösség

Ha bármilyen kérdése van, segítséget kaphat a fejlesztői közösségben.