Dokumentation

Referens till API

Förenkla och översätt innehåll till 24 utdataspråk.

Den synkrona slutpunkten accepterar källtext, en utdatalokal och ett av två lägen. Den upptäcker källspråket automatiskt och returnerar ett resultat som är klart att använda i det valda utmatningsspråket.

{
  "text": "Komplext källinnehåll på det valda språket.",
  "locale": "sv",
  "mode": "simple-language"
}

SDK- och cURL-exempel tillgängliga

Slutpunkt

POST /api/v2/translate

Skapa ett vanligt språk eller enkelt språkresultat och returnera det i samma HTTP-svar.

Förbehållna rubriker

HögreVärdeSyftet
AuthorizationBearer <API_KEY>Autentiserar projektet med det aktuella HTTP-bärarschemat
Content-TypeAnsökan/jsonAnmäler formats för begäran
AcceptAnsökan/jsonFrågar om ett JSON-svar
Idempotency-KeyKrävs endast för jobb och partierHåller upprepade asynkrona inlämningar från att skapa dubbletter av arbete

Ansökningsorgan

Ingen annan innehållsinställning är en del av det offentliga begärandeschemat.

FältTypFörpliktelserTillåtna värdenBeskrivning
textSträng- Ja, det är det.1 till 10 000 Unicode-teckenKällainnehåll i den valda platsen
localeSträng- Ja, det är det.En av 24 stödda två bokstavliga koderUtmatningsspråk. Källspråket detekteras automatiskt.
modeSträng- Ja, det är det.Enkelt språk, lätt språkFörenklingsläge
json
{
  "text": "Applicants must provide the required documentation before the deadline.",
  "locale": "en",
  "mode": "easy-language"
}

Svarsorgan

Svaret får inte innehålla inställda förfrågningar eller en separat kvalitetsinformationsuppsättning.

FältTypBeskrivning
requestIdSträngUnique identifierare för stöd och logg
localeSträngValt utdataspråk
modeSträngVäljts förenklingsläge
outputSträngFärdigt resultat i den valda utdatalokalen
usage.inputCharactersintegerTecken räknas för denna begäran, eller 0 för en cacheträff
usage.cacheHitboolesktHuruvida resultatet kom från 30-dagarscachen
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
  }
}

Valideringsbeteende

  • Saknad text: avvisas med ett dokumenterat fältfel.
  • Tydlig text: avvisa med ett dokumenterat fältfel.
  • Stödda platser: avvisa; aldrig i stilla ersätta en annan plats.
  • Stödlöst läge: avvisa; aldrig välja ett läge automatiskt.
  • Okänt pensionerat fält: avvisa med ett migrationsfokuserat fel eller hantera endast via ett uttryckligen versionerat kompatibilitetslag.
  • Källtexten kan använda ett annat språk än språket. Simple8 upptäcker källspråket automatiskt och skriver resultatet i det valda utdataspråket.