API für közérthető nyelv és könnyen érthető kommunikáció.
Küldje el a forrásszöveget, a kívánt célnyelvet és a két nyelvi mód egyikét. A Simple8 automatikusan felismeri a forrásnyelvet, és a kész szöveget a célnyelven adja vissza.
{
"text": "Összetett forrástartalom a kiválasztott nyelven.",
"locale": "hu",
"mode": "simple-language"
}SDK- és cURL-példák állnak rendelkezésre
Végpont
POST /api/v2/translate
Egyszerű vagy egyszerű nyelvű szöveget hoz létre, és közvetlenül a HTTP-válaszban adja vissza.
Szükséges címkék
| Főcím | Érték | Cél |
|---|---|---|
| Authorization | Bearer <API_KEY> | Munkaterület-hitelesítés |
| Content-Type | kérelmezés/json | Bejelenti, hogy a kérelmek JSON-t tartalmaznak |
| Accept | kérelmezés/json | Kér egy JSON-re válasz |
| Idempotency-Key | Csak háttér- és kollektív megrendelésekhez szükséges | Megakadályozza a kettős háttérmegbízásokat |
Kérési szerv
Más tartalombeállítás nem része a nyilvános kérési sémának.
| A mező | A típus | Szükséges | Megengedett érték | Fontos leírás |
|---|---|---|---|---|
| text | szálak | Igen, igen. | 1-5 000 NFC-normalizált Unicode-kódpont | Az előzetes szöveg |
| locale | szálak | Igen, igen. | A 136 támogatott, 2 vagy 3 betűs kód egyike | Kimeneti nyelv. A rendszer automatikusan felismeri a forrásnyelvet. |
| mode | szálak | Igen, igen. | simple-language, easy-language | Egyszerűsítés módja |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Választagó test
A válasz tartalmazza a kész szöveget és a dokumentált felhasználási adatokat.
| A mező | A típus | Fontos leírás |
|---|---|---|
| requestId | szálak | A támogatások és a naplók egyedi azonosítója |
| locale | szálak | Kiválasztott célnyelv |
| mode | szálak | Választott egyszerűsítési mód |
| output | szálak | Kész szöveg a kiválasztott célnyelven |
| usage.inputCharacters | teljes szám | Ennél a kérésnél a karakterek száma, a gyorsítótár-lekérések esetén pedig 0 |
| usage.cacheHit | logikai érték | Hogy az eredmény a 180 napos gyorsítótárból származott-e |
{
"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
}
}A hitelesítési viselkedés
- A hiányzó, üres, ismeretlen vagy érvénytelen mezők HTTP 400 választ adnak invalid_request hibakóddal és ellenőrzési részletekkel.
- A szöveg hosszát az NFC-normalizálás után, Unicode-kódpontokban mérjük.
- A területi beállításnak a 136 dokumentált, 2 vagy 3 betűs kód egyikének kell lennie.
- A módnak pontosan simple-language vagy easy-language értékűnek kell lennie.
- 126.§ A forrásszöveg a megadottól eltérő nyelven is írható. A Simple8 automatikusan felismeri a nyelvet, és a kiválasztott célnyelven hozza létre az eredményt.