Semplifica e traduci i contenuti in 24 lingue di output.

L'endpoint sincrono accetta testo di origine, impostazioni internazionali di output e una delle due modalità. Rileva automaticamente la lingua di origine e restituisce un risultato pronto per l'uso nella lingua di output selezionata.

{
  "text": "Contenuti originali complessi nella lingua selezionata.",
  "locale": "it",
  "mode": "simple-language"
}

Esempi di SDK e cURL disponibili

Punto di destinazione

POST /api/v2/translate

Crea un risultato Plain Language o Easy Language e restituiscilo nella stessa risposta HTTP.

Titolo richiesto

Inseritori	Valore	Scopo
Authorization	Bearer <API_KEY>	Autentica il progetto con lo schema di connessione HTTP corrente
Content-Type	domanda/json	Declare il formato del corpo della richiesta
Accept	domanda/json	Richiede una risposta JSON
Idempotency-Key	Obbligatorio solo per lavori e batch	Impedisce che invii asincroni ripetuti creino lavori duplicati

Organismo di richiesta

Nessun'altra impostazione del contenuto fa parte dello schema di richiesta pubblica.

Campo	Tipo di prodotto	Requisiti	Valore consentito	Descrizione
text	string	- Sì, sì.	Da 1 a 10.000 caratteri Unicode	Contenuto sorgente nella località selezionata
locale	string	- Sì, sì.	Uno dei 24 codici a due lettere supportati	Lingua di uscita. La lingua di origine viene rilevata automaticamente.
mode	string	- Sì, sì.	- un linguaggio semplice, facile.	Modulo di semplificazione

{
  "text": "Applicants must provide the required documentation before the deadline.",
  "locale": "en",
  "mode": "easy-language"
}

Organismo di risposta

La risposta non deve contenere impostazioni della richiesta ritirata o un array separato di informazioni sulla qualità.

Campo	Tipo di prodotto	Descrizione
requestId	string	Identificatore unico per supporto e registri
locale	string	Località di output selezionata
mode	string	Modalità di semplificazione selezionata
output	string	Risultato finale nella locale di output selezionata
usage.inputCharacters	numero intero	I caratteri sono stati contati per questa richiesta o 0 per un riscontro nella cache
usage.cacheHit	booleano	Se il risultato proviene dalla cache di 30 giorni

{
  "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
  }
}

Comportamento di convalida

Mancano testi: respingono con un errore di campo documentato.
testo vuoto: respingere con un errore di campo documentato.
Locale non supportato: rifiutare; mai sostituire silenziosamente un'altra locale.
Modalità non supportata: rifiutare; non scegliere mai una modalità automaticamente.
Campo ritirato sconosciuto: respingere con un errore di migrazione o gestire solo attraverso uno strato di compatibilità esplicitamente modificato.
Il testo di origine può utilizzare una lingua diversa da quella locale. Simple8 rileva automaticamente la lingua di origine e scrive il risultato nella locale di output selezionata.

In questa pagina