API för klarspråk och lätt språk.
Skicka din källtext, önskat målspråk och ett av de två språklägena. Simple8 erkänner automatiskt källspråket och returnerar den färdiga texten på målsprå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
Skapar en text på ett enkelt eller enkelt språk och returnerar den direkt i HTTP-responsen.
Förbehållna rubriker
| Högre | Värde | Syftet |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autentisering av arbetsyta |
| Content-Type | Ansökan/json | Indikerar att begäran innehåller JSON |
| Accept | Ansökan/json | Frågar om ett JSON-svar |
| Idempotency-Key | Endast krävs för bakgrund och bulk order | Förhindrar dubbla bakgrundsbeställningar |
Ansökningsorgan
Ingen annan innehållsinställning är en del av det offentliga begärandeschemat.
| Fält | Typ | Förpliktelser | Tillåtna värden | Beskrivning |
|---|---|---|---|---|
| text | Sträng | - Ja, det är det. | 1 till 5 000 NFC-normaliserade Unicode-kodpunkter | Källa text |
| locale | Sträng | - Ja, det är det. | En av 136 koder med 2 eller 3 bokstäver som stöds | Utmatningsspråk. Källspråket detekteras automatiskt. |
| mode | Sträng | - Ja, det är det. | simple-language, easy-language | Förenklingsläge |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Svarsorgan
Svaret innehåller den färdiga texten och dokumenterade användningsdata.
| Fält | Typ | Beskrivning |
|---|---|---|
| requestId | Sträng | Unique identifierare för stöd och logg |
| locale | Sträng | Valt målspråk |
| mode | Sträng | Väljts förenklingsläge |
| output | Sträng | Redo text i det valda målspråket |
| usage.inputCharacters | integer | Tecken räknas för denna begäran, eller 0 för en cacheträff |
| usage.cacheHit | booleskt | Huruvida resultatet kom från 180-dagarscachen |
{
"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
- Fält som saknas, är tomma, okända eller ogiltiga returnerar HTTP 400 med felkoden invalid_request och valideringsuppgifter.
- Textlängden mäts i Unicode-kodpunkter efter NFC-normalisering.
- Språkkoden måste vara en av de 136 dokumenterade koderna med 2 eller 3 bokstäver.
- Läget måste vara exakt simple-language eller easy-language.
- Simple8 erkänner automatiskt källtextens språk och skapar resultatet i det valda målspråket.