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ögre | Värde | Syftet |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autentiserar projektet med det aktuella HTTP-bärarschemat |
| Content-Type | Ansökan/json | Anmäler formats för begäran |
| Accept | Ansökan/json | Frågar om ett JSON-svar |
| Idempotency-Key | Krävs endast för jobb och partier | Hå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ält | Typ | Förpliktelser | Tillåtna värden | Beskrivning |
|---|---|---|---|---|
| text | Sträng | - Ja, det är det. | 1 till 10 000 Unicode-tecken | Källainnehåll i den valda platsen |
| locale | Sträng | - Ja, det är det. | En av 24 stödda två bokstavliga koder | Utmatningsspråk. Källspråket detekteras automatiskt. |
| mode | Sträng | - Ja, det är det. | Enkelt språk, lätt språk | Förenklingsläge |
{
"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ält | Typ | Beskrivning |
|---|---|---|
| requestId | Sträng | Unique identifierare för stöd och logg |
| locale | Sträng | Valt utdataspråk |
| mode | Sträng | Väljts förenklingsläge |
| output | Sträng | Färdigt resultat i den valda utdatalokalen |
| 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 30-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
- 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.