Dokumentācija

API atsauce

Vienkāršojiet un tulkojiet saturu 24 izvades valodās.

Sinhronais galapunkts pieņem avota tekstu, izvades lokalizāciju un vienu no diviem režīmiem. Tas automātiski nosaka avota valodu un atgriež lietošanai gatavu rezultātu atlasītajā izvades valodā.

{
  "text": "Sarežģīts avota saturs atlasītajā valodā.",
  "locale": "lv",
  "mode": "simple-language"
}

Pieejami SDK un cURL piemēri

Galvenā punkta

POST /api/v2/translate

Izveidojiet vienu vienkāršās valodas vai vienkāršas valodas rezultātu un atgrieziet to tajā pašā HTTP atbildē.

Vajadzīgi virsraksti

GalvenāValūtaNodrošinājums
AuthorizationBearer <API_KEY>Autentificē projektu ar pašreizējo HTTP nesēja shēmu
Content-Typepieteikums/jsonIzvēlas pieprasījuma struktūras formātu
Acceptpieteikums/jsonPieteikums JSON atbildi
Idempotency-KeyNepieciešams tikai darbiem un partijāmNeļauj atkārtotiem asinhroniem iesniegumiem radīt dublētus darbus

Pieprasījuma struktūra

Neviens cits satura iestatījums neietilpst publiskā pieprasījuma shēmā.

LaukaTipsVajadzībaPieļaujama vērtībaApzīmējums
textķēdesJā, tā ir.No 1 līdz 10 000 unikoda rakstzīmēmIzvēlētajā vietnē ir avota saturs
localeķēdesJā, tā ir.Viens no 24 atbalstītajiem divstoņveida kodiemIzvades valoda. Avota valoda tiek noteikta automātiski.
modeķēdesJā, tā ir.vienkārša, vienkārša valodavienkāršošanas režīms
json
{
  "text": "Applicants must provide the required documentation before the deadline.",
  "locale": "en",
  "mode": "easy-language"
}

Reakcijas struktūra

Atbildē nedrīkst būt ietverti anulēti pieprasījuma iestatījumi vai atsevišķs kvalitātes informācijas masīvs.

LaukaTipsApzīmējums
requestIdķēdesVienotīgs identifikators atbalsta un žurnāla vajadzībām
localeķēdesAtlasītā izvades lokalizācija
modeķēdesIzvēlēts vienkāršošanas režīms
outputķēdesPabeigts rezultāts atlasītajā izvades lokalizācijā
usage.inputCharacterspilns skaitlisŠim pieprasījumam tiek ieskaitītas rakstzīmes vai 0  - kešatmiņas trāpījumam
usage.cacheHitBūlaNeatkarīgi no tā, vai rezultāts tika iegūts no 30 dienu kešatmiņas
json
{
  "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
  }
}

Validācijas uzvedība

  • Izmantojot tekstu: atmest ar dokumentētu lauku kļūdu.
  • Tuvs teksts: atmest ar dokumentētu laukuma kļūdu.
  • Neatbalsta vietne: noraidīt; nekad klusīgi aizstāt citu vietni.
  • Neatbalsta režīms: noraidīt; nekad automātiski neizmantot režīmu.
  • Neatzīstams atkāpjies laukums: noraidīt ar migrācijas koncentrēto kļūdu vai apstrādāt tikai ar skaidri izformētu saderības slogu.
  • Avota tekstā var tikt izmantota valoda, kas atšķiras no lokalizācijas. Simple8 automātiski nosaka avota valodu un ieraksta rezultātu atlasītajā izvades lokalizācijā.