REFERENZA għall-API
Issimplifika u ttraduċi l-kontenut f'24 lingwa tal-ħruġ.
L-endpoint sinkroniku jaċċetta test sors, lokalizzazzjoni tal-output, u waħda miż-żewġ modi. Jiskopri l-lingwa tas-sors awtomatikament u jirritorna riżultat lest għall-użu fil-lingwa tal-output magħżula.
{
"text": "Kontenut sors kumpless fil-lingwa magħżula.",
"locale": "mt",
"mode": "simple-language"
}Eżempji SDK u cURL disponibbli
Il-punt finali
POST /api/v2/translate
Oħloq riżultat wieħed ta' Lingwa Sempliċi jew Lingwa Faċli u rritornah fl-istess rispons HTTP.
Titli meħtieġa
| In-Negozju | Valur | L-iskop |
|---|---|---|
| Authorization | Bearer <API_KEY> | Jawtentika l-proġett bl-iskema attwali HTTP Bearer |
| Content-Type | Applikazzjoni/ġestjoni | Iddikjara l-format tal-korp tal-applikazzjoni |
| Accept | Applikazzjoni/ġestjoni | Talb għal tweġiba JSON |
| Idempotency-Key | Meħtieġa għal impjiegi u lottijiet biss | Iżomm is-sottomissjonijiet asinkroniċi ripetuti milli joħolqu xogħol duplikat |
Organu tal-applikazzjoni
L-ebda setting ta' kontenut ieħor ma huwa parti mill-iskema ta' talba pubblika.
| Il-qasam | Tip | Reġistrazzjoni | Valur permess | Deskrizzjoni |
|---|---|---|---|---|
| text | stringa | Iva, | 1 sa 10,000 karattru Unicode | Il- kontenut tas- sors fil- lokalizzazzjoni magħżula |
| locale | stringa | Iva, | Wieħed minn 24 kodiċi b'żewġ ittri appoġġati | Lingwa tal-ħruġ. Il-lingwa tas-sors tiġi skoperta awtomatikament. |
| mode | stringa | Iva, | Il-lingwa sempliċi, il-lingwa faċli | Mod ta' simplifikazzjoni |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}korp ta' rispons
Ir-rispons m'għandux ikun fih settings ta' talba rtirati jew firxa separata ta' informazzjoni ta' kwalità.
| Il-qasam | Tip | Deskrizzjoni |
|---|---|---|
| requestId | stringa | Identifikatur uniku għall-appoġġ u l-logs |
| locale | stringa | Lokal tal-ħruġ magħżul |
| mode | stringa | Mod ta' simplifikazzjoni magħżul |
| output | stringa | Riżultat lest fil-lokal tal-output magħżul |
| usage.inputCharacters | numru sħiħ | Karattri magħduda għal din it-talba, jew 0 għal hit cache |
| usage.cacheHit | boolean | Jekk ir-riżultat ġiex mill-cache ta’ 30 jum |
{
"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
}
}Komportament ta' validazzjoni
- Tittest li nieqes: irrifjuta b'iżball fil-qasam dokumentat.
- It-test vojt: irrifjuta b'iżball fil-qasam dokumentat.
- Lokali mhux appoġġjati: irrifjuta; qatt ma jissostitwixxi lokali ieħor bil-ħeffa.
- Mod mhux appoġġjat: jirrifjuta; qatt ma tagħżel mod awtomatikament.
- Il-kamp imġarrba mhux magħruf: irrifjuta b'iżball iffukat fuq il-migrazzjoni jew jittratta biss permezz ta' saff ta' kompatibbiltà li jkun ġie vverifikat espliċitament.
- It-test tas-sors jista' juża lingwa differenti mil-lokal. Simple8 jiskopri l-lingwa tas-sors awtomatikament u jikteb ir-riżultat fil-lokal tal-output magħżul.