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
| Overskrifter | Værdi | Formålet |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autentificerer projektet med det aktuelle HTTP-bærerskema |
| Content-Type | ansøgning/json | Anmeldelse af formatsformatet for anmodningen |
| Accept | ansøgning/json | Anmoder et JSON-respons |
| Idempotency-Key | Kun påkrævet for job og batches | Holder gentagne asynkrone indsendelser fra at skabe duplikatarbejde |
Anmodningskomité
Ingen anden indholdsindstilling er en del af det offentlige anmodningsskema.
| Feltet | Typ | Indhold | Tilladt værdi | Beskrivelse |
|---|---|---|---|---|
| text | String | - Ja, det er det. | 1 til 10.000 Unicode-tegn | Kildeindhold i den valgte lokalisering |
| locale | String | - Ja, det er det. | En af 24 støttede to bogstaver kode | Output sprog. Kildesproget detekteres automatisk. |
| mode | String | - Ja, det er det. | Enkelt sprog, let sprog | Forenkling |
{
"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.
| Feltet | Typ | Beskrivelse |
|---|---|---|
| requestId | String | Unique identifikator for støtte og logs |
| locale | String | Valgt output-lokalitet |
| mode | String | Udvalgt forenklingstilstand |
| output | String | Færdigt resultat i den valgte output-lokale |
| usage.inputCharacters | hele tal | Tegn talt for denne anmodning, eller 0 for et cachehit |
| usage.cacheHit | boolesk | Om resultatet kom fra 30-dages cache |
{
"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.