API per linguaggio semplice e linguaggio facile.
Invia il tuo testo sorgente, la lingua di destinazione desiderata e una delle due modalità di lingua. Simple8 riconosce automaticamente la lingua di origine e restituisce il testo finito nella lingua di destinazione.
{
"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 testo in lingua semplice o semplice e lo restituisce direttamente nella risposta HTTP.
Titolo richiesto
| Inseritori | Valore | Scopo |
|---|---|---|
| Authorization | Bearer <API_KEY> | Autenticazione dell'area di lavoro |
| Content-Type | domanda/json | Indica che la richiesta contiene JSON |
| Accept | domanda/json | Richiede una risposta JSON |
| Idempotency-Key | Solo richiesto per gli ordini di sfondo e di massa | Previene duplicare gli ordini di sfondo |
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 5.000 punti di codice Unicode normalizzati con NFC | Testo sorgente |
| locale | string | - Sì, sì. | Uno dei 136 codici supportati di 2 o 3 lettere | Lingua di uscita. La lingua di origine viene rilevata automaticamente. |
| mode | string | - Sì, sì. | simple-language, easy-language | Modulo di semplificazione |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Organismo di risposta
La risposta contiene il testo finito e i dati di utilizzo documentati.
| Campo | Tipo di prodotto | Descrizione |
|---|---|---|
| requestId | string | Identificatore unico per supporto e registri |
| locale | string | Lingua target selezionata |
| mode | string | Modalità di semplificazione selezionata |
| output | string | Testo pronto nella lingua di destinazione 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 180 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
- I campi mancanti, vuoti, sconosciuti o non validi restituiscono HTTP 400 con il codice di errore invalid_request e i dettagli di convalida.
- La lunghezza del testo viene misurata in punti di codice Unicode dopo la normalizzazione NFC.
- Le impostazioni locali devono corrispondere a uno dei 136 codici documentati di 2 o 3 lettere.
- La modalità deve essere esattamente simple-language o easy-language.
- Simple8 riconosce automaticamente la lingua del testo sorgente e crea il risultato nella lingua selezionata.