Dokumentacija

API nuorodos

Supaprastinkite ir išverskite turinį į 24 išvesties kalbas.

Sinchroninis galutinis taškas priima šaltinio tekstą, išvesties lokalę ir vieną iš dviejų režimų. Jis automatiškai aptinka šaltinio kalbą ir grąžina naudojimui paruoštą rezultatą pasirinkta išvesties kalba.

{
  "text": "Sudėtingas šaltinio turinys pasirinkta kalba.",
  "locale": "lt",
  "mode": "simple-language"
}

Galimi SDK ir cURL pavyzdžiai

Baigiamasis punktas

POST /api/v2/translate

Sukurkite vieną paprastos kalbos arba paprastos kalbos rezultatą ir grąžinkite jį tame pačiame HTTP atsakyme.

Reikalingos antraštinės dalys

ŠkyrosVertybėPaslaugos
AuthorizationBearer <API_KEY>Autentifikuoja projektą pagal dabartinę HTTP nešiklio schemą
Content-Typeprašymas/jsonPareiškimo forma
Acceptprašymas/jsonPrašo JSON atsakymo
Idempotency-KeyReikalingas tik darbams ir partijomsApsaugo, kad pakartotiniai asinchroniniai pateikimai nesukurtų pasikartojančių darbų

Prašymo įstaiga

Joks kitas turinio nustatymas nėra viešosios užklausos schemos dalis.

LaikasTipasReikalingasLeistina vertėAprašymas
texteilutėsTaip.Nuo 1 iki 10 000 unikodo simboliųIšvestinis turinys pasirinktoje vietovėje
localeeilutėsTaip.Vienas iš 24 palaikomų dviejų raidžių kodoIšvesties kalba. Šaltinio kalba aptinkama automatiškai.
modeeilutėsTaip.paprasta kalba, paprasta kalbaPaprastinimo būdas
json
{
  "text": "Applicants must provide the required documentation before the deadline.",
  "locale": "en",
  "mode": "easy-language"
}

Reakcijos įstaiga

Atsakyme neturi būti pašalintų užklausų nustatymų arba atskiro kokybės informacijos masyvo.

LaikasTipasAprašymas
requestIdeilutėsUnikali paramos ir žurnalo identifikavimo ženklas
localeeilutėsPasirinkta išvesties lokalė
modeeilutėsPasirinktas supaprastinimo režimas
outputeilutėsBaigtas rezultatas pasirinktoje išvesties lokalėje
usage.inputCharactersvienetasŠiai užklausai skaičiuojami simboliai arba 0 talpyklos įvykiui
usage.cacheHitloginisNesvarbu, ar rezultatas buvo gautas iš 30 dienų talpyklos
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
  }
}

Validacijos elgesys

  • Nėra teksto: atmesti su dokumentuota lauko klaida.
  • Tuščias tekstas: atmesti su dokumentuota lauko klaida.
  • Nepalaikytas vietovė: atmesti; niekada tylingai pakeisti kitą vietovę.
  • Nepalaikytas režimas: atmesti; niekada nepaklauskite režimo automatiškai.
  • Nepažįstamas atstovaus laukas: atmesti migracijos orientuota klaida arba tvarkyti tik aiškiai versijavus suderinamumo sluoksnį.
  • Šaltinio teksto kalba gali skirtis nuo lokalės. Simple8 automatiškai aptinka šaltinio kalbą ir įrašo rezultatą į pasirinktą išvesties lokalę.