Regisztrálj fejlesztőként és szerezz API kulcsot
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.
Gyors hozzáférés
Alap 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
- Hiányzó kötelező paraméterek, érvénytelen paraméterformátumok vagy enum értékek, hiányzó fájlfeltöltés, feltöltés mentési hiba vagy feladatfeldolgozási hiba.
- 401 Unauthorized
- Hiányzó vagy érvénytelen API kulcs.
- 402 Payment Required
- Nincs elegendő kreditegyenleg az előnézethez, a teljes fordításhoz vagy a szövegfordításhoz.
- 404 Not Found
- A feladat vagy szójegyzék nem létezik, törölve lett, nem tartozik a jelenlegi API fiókhoz, vagy nem az API-n keresztül lett létrehozva.
- 409 Conflict
- A jelenlegi feladat állapota nem teszi lehetővé a kért műveletet.
- 500 Internal Server Error
- Váratlan szerverhiba. A válaszhiba "Internal server error."-ra van beállítva.
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
Fizessen szükség szerint a teljes szöveg fordításáért; indítsa újra a feladatot, módosítsa a szöveget vagy törölje a feladatot.