Dokumentation

Reference til API

Forenkle og oversæt indhold til 24 outputsprog.

Det synkrone slutpunkt accepterer kildetekst, en output-lokalitet og en af to tilstande. Den registrerer automatisk kildesproget og returnerer et resultat, der er klar til brug på det valgte outputsprog.

{
  "text": "Kompleks kildeindhold på det valgte sprog.",
  "locale": "da",
  "mode": "simple-language"
}

Eksempler på SDK og cURL tilgængelige

Endpunkt

POST /api/v2/translate

Opret ét almindeligt sprog eller let sprogresultat, og returner det i det samme HTTP-svar.

Indholdsregler

OverskrifterVærdiFormålet
AuthorizationBearer <API_KEY>Autentificerer projektet med det aktuelle HTTP-bærerskema
Content-Typeansøgning/jsonAnmeldelse af formatsformatet for anmodningen
Acceptansøgning/jsonAnmoder et JSON-respons
Idempotency-KeyKun påkrævet for job og batchesHolder gentagne asynkrone indsendelser fra at skabe duplikatarbejde

Anmodningskomité

Ingen anden indholdsindstilling er en del af det offentlige anmodningsskema.

FeltetTypIndholdTilladt værdiBeskrivelse
textString- Ja, det er det.1 til 10.000 Unicode-tegnKildeindhold i den valgte lokalisering
localeString- Ja, det er det.En af 24 støttede to bogstaver kodeOutput sprog. Kildesproget detekteres automatisk.
modeString- Ja, det er det.Enkelt sprog, let sprogForenkling
json
{
  "text": "Applicants must provide the required documentation before the deadline.",
  "locale": "en",
  "mode": "easy-language"
}

Reaktionskontor

Svaret må ikke indeholde tilbagetrukne anmodningsindstillinger eller et separat kvalitetsinformationsarray.

FeltetTypBeskrivelse
requestIdStringUnique identifikator for støtte og logs
localeStringValgt output-lokalitet
modeStringUdvalgt forenklingstilstand
outputStringFærdigt resultat i den valgte output-lokale
usage.inputCharactershele talTegn talt for denne anmodning, eller 0 for et cachehit
usage.cacheHitbooleskOm resultatet kom fra 30-dages cache
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
  }
}

Valideringsadfærd

  • Fraværende tekst: afvise med en dokumenteret feltfejl.
  • Tøm tekst: afvise med en dokumenteret felter.
  • Ustøttede lokaler: afvise; aldrig stille erstatte en anden lokaler.
  • Ustøttede modus: afvise; aldrig vælge en modus automatisk.
  • Ukendt retireret felt: afvise med en migrationsfokuseret fejl eller håndterer kun gennem et eksplicit versioneret kompatibilitetslag.
  • Kildeteksten kan bruge et andet sprog end lokaliteten. Simple8 detekterer kildesproget automatisk og skriver resultatet i den valgte output-lokalitet.