Dokumentáció

A BÉRENNÉS

Egyszerűsítse és fordítsa le a tartalmat 24 kimeneti nyelvre.

A szinkron végpont elfogadja a forrásszöveget, a kimeneti területi beállítást és a két mód egyikét. Automatikusan felismeri a forrásnyelvet, és egy használatra kész eredményt ad vissza a kiválasztott kimeneti nyelven.

{
  "text": "Összetett forrástartalom a kiválasztott nyelven.",
  "locale": "hu",
  "mode": "simple-language"
}

SDK- és cURL-példák állnak rendelkezésre

Végpont

POST /api/v2/translate

Hozzon létre egy egyszerű nyelvű vagy egyszerű nyelvű eredményt, és adja vissza ugyanabban a HTTP-válaszban.

Szükséges címkék

FőcímÉrtékCél
AuthorizationBearer <API_KEY>Hitelesíti a projektet a jelenlegi HTTP-hordozó sémával
Content-Typekérelmezés/jsonA kérelem szerv formátumának bejelölése
Acceptkérelmezés/jsonKér egy JSON-re válasz
Idempotency-KeyCsak munkákhoz és kötegekhez szükségesMegakadályozza, hogy az ismételt aszinkron beküldések ismétlődő munkát hozzon létre

Kérési szerv

Más tartalombeállítás nem része a nyilvános kérési sémának.

A mezőA típusSzükségesMegengedett értékFontos leírás
textszálakIgen, igen.1-10 000 Unicode karakterForrástartalom a kiválasztott helyben
localeszálakIgen, igen.24 támogatott két betűs kód közül egyKimeneti nyelv. A rendszer automatikusan felismeri a forrásnyelvet.
modeszálakIgen, igen.Egyszerű, egyszerű nyelvEgyszerűsítés módja
json
{
  "text": "Applicants must provide the required documentation before the deadline.",
  "locale": "en",
  "mode": "easy-language"
}

Választagó test

A válasz nem tartalmazhat visszavont kérésbeállításokat vagy külön minőségi információs tömböt.

A mezőA típusFontos leírás
requestIdszálakA támogatások és a naplók egyedi azonosítója
localeszálakKiválasztott kimeneti terület
modeszálakVálasztott egyszerűsítési mód
outputszálakKész eredmény a kiválasztott kimeneti nyelven
usage.inputCharactersteljes számEnnél a kérésnél a karakterek száma, a gyorsítótár-lekérések esetén pedig 0
usage.cacheHitlogikai értékHogy az eredmény a 30 napos gyorsítótárból származott-e
json
{
  "requestId": "req_sync_002",
  "locale": "en",
  "mode": "easy-language",
  "output": "You need to send documents.\nSend the documents before the deadline.",
  "usage": {
    "inputCharacters": 78,
    "cacheHit": false
  }
}

A hitelesítési viselkedés

  • Hiányzó szöveg: dokumentált mező hibával elutasítsák.
  • Üres szöveg: dokumentált mező hibával elutasítsuk.
  • Támogatatlan hely: elutasítsd; soha ne csendben helyettesíts más hely.
  • A támogatott mód: elutasítsd; soha ne válaszd automatikusan a módot.
  • Nem ismert visszavonult mező: a migrációra összpontosító hiba esetén elutasítsuk, vagy csak egy kifejezetten verziós kompatibilitási réteg segítségével kezeljük.
  • A forrásszöveg a területi beállítástól eltérő nyelvet használhat. Az Simple8 automatikusan felismeri a forrásnyelvet, és az eredményt a kiválasztott kimeneti területre írja.