API til klart sprog og let sprog.
Send din kildetekst, det ønskede målsprog og en af de to sprogtilstande. Simple8 registrerer automatisk kildesproget og returnerer den færdige tekst på målsproget.
{
"text": "Kompleks kildeindhold på det valgte sprog.",
"locale": "da",
"mode": "simple-language"
}Eksempler på SDK og cURL tilgængelige
Endpunkt
POST /api/v2/translate
Opretter en tekst i almindeligt eller almindeligt sprog og returnerer den direkte i HTTP-svaret.
Indholdsregler
| Overskrifter | Værdi | Formålet |
|---|---|---|
| Authorization | Bearer <API_KEY> | Godkendelse af arbejdsområde |
| Content-Type | ansøgning/json | Angiv, at forespørgslen indeholder JSON |
| Accept | ansøgning/json | Anmoder et JSON-respons |
| Idempotency-Key | Kun påkrævet for baggrunds- og kollektive ordrer | Forhindrer dobbelt-baggrundopdrag |
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 5.000 NFC-normaliserede Unicode-kodepunkter | Udgangstekst |
| locale | String | - Ja, det er det. | En af 136 understøttede koder på 2 eller 3 bogstaver | Output sprog. Kildesproget detekteres automatisk. |
| mode | String | - Ja, det er det. | simple-language, easy-language | Forenkling |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Reaktionskontor
Svaret indeholder den færdige tekst og de dokumenterede brugsdata.
| Feltet | Typ | Beskrivelse |
|---|---|---|
| requestId | String | Unique identifikator for støtte og logs |
| locale | String | Valgt målsprog |
| mode | String | Udvalgt forenklingstilstand |
| output | String | Færdig tekst på det valgte målsprog |
| usage.inputCharacters | hele tal | Tegn talt for denne anmodning, eller 0 for et cachehit |
| usage.cacheHit | boolesk | Om resultatet kom fra 180-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
- Manglende, tomme, ukendte eller ugyldige felter returnerer HTTP 400 med fejlkoden invalid_request og valideringsoplysninger.
- Tekstlængden måles i Unicode-kodepunkter efter NFC-normalisering.
- Landestandarden skal være en af de 136 dokumenterede koder på 2 eller 3 bogstaver.
- Tilstanden skal være præcis simple-language eller easy-language.
- Kildeteksten kan være skrevet på et andet sprog end det angivne. Simple8 registrerer automatisk sproget og opretter resultatet på det valgte målsprog.