API pro srozumitelný jazyk a snadné čtení.
Odešlete zdrojový text, požadovaný cílový jazyk a jeden ze dvou jazykových režimů. Simple8 automaticky rozpozná zdrojový jazyk a vrátí hotový text v cílovém jazyce.
{
"text": "Komplexní zdrojový obsah ve zvoleném jazyce.",
"locale": "cs",
"mode": "simple-language"
}Dostupné příklady SDK a cURL
Výsledný bod
POST /api/v2/translate
Vytvoří prostý nebo prostý text a vrátí jej přímo v HTTP odpovědi.
Požadované názevky
| Vzdělání | Hodnota | Účelem |
|---|---|---|
| Authorization | Bearer <API_KEY> | Ověření pracovního prostoru |
| Content-Type | žádost/json | Uveďte, že dotaz obsahuje JSON |
| Accept | žádost/json | Požaduje odpověď JSON |
| Idempotency-Key | Vyžaduje se pouze pro podkladové a hromadné objednávky | Způsobení, které se provádí v rámci programu "Duplex" |
Žádostní orgán
Žádné další nastavení obsahu není součástí schématu veřejných požadavků.
| Polní | Typ | Požadavky | Dopuszovaná hodnota | Popis |
|---|---|---|---|---|
| text | řetěz | Ano, ano. | 1 až 5 000 bodů kódu Unicode normalizovaných pomocí NFC | Vytvoření |
| locale | řetěz | Ano, ano. | Jeden ze 136 podporovaných dvou- nebo třípísmenných kódů | Výstupní jazyk. Zdrojový jazyk je detekován automaticky. |
| mode | řetěz | Ano, ano. | simple-language, easy-language | Přípravek zjednodušení |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Odpovědní orgán
Odpověď obsahuje hotový text a dokumentované údaje o použití.
| Polní | Typ | Popis |
|---|---|---|
| requestId | řetěz | Jedinečný identifikátor pro podporu a záznamy |
| locale | řetěz | Zvolený cílový jazyk |
| mode | řetěz | Vybraný režim zjednodušení |
| output | řetěz | Hotový text ve zvoleném cílovém jazyce |
| usage.inputCharacters | celá čísla | Znaky započítané pro tento požadavek nebo 0 pro přístup do mezipaměti |
| usage.cacheHit | booleovský | Zda výsledek pochází z 180denní mezipaměti |
{
"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
}
}Ověřovací chování
- Chybějící, prázdná, neznámá nebo neplatná pole vrátí HTTP 400 s kódem chyby invalid_request a podrobnostmi ověření.
- Délka textu se měří po normalizaci NFC v bodech kódu Unicode.
- Národní prostředí musí být jedním ze 136 zdokumentovaných dvou- nebo třípísmenných kódů.
- Režim musí být přesně simple-language nebo easy-language.
- Zdrojový text může být napsán v jiném než uvedeném jazyce. Simple8 automaticky rozpozná jazyk a vytvoří výsledek ve zvoleném cílovém jazyce.