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://shangyiai.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álasz hiba "Belső szerver hiba."-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
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.