Documentazione

Scegli come il tuo sistema riceve il risultato.

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

Esempi di SDK e cURL disponibili

HTTP sincrono

Ogni modello utilizza gli stessi campi principali: testo, locale e modalità.

Punto di destinazione

POST /api/v2/translate

- Perfetto .

Contenuto breve e azioni di backend dirette.

Successo

200 OK

Streaming

La risposta utilizza Content-Type: text/event-stream.

Punto di destinazione

POST /api/v2/translate/stream

- Perfetto .

Interfacce progressive e contenuti più lunghi.

{
  "text": "Source content in the selected language.",
  "locale": "en",
  "mode": "easy-language"
}

event: meta
data: {"requestId":"req_stream_001","locale":"en","mode":"easy-language"}

event: delta
data: {"delta":"Complete result."}

event: done
data: {"usage":{"inputCharacters":42,"cacheHit":false}}

Lo stream emette un meta evento, uno o più eventi delta e un evento finale completato.

Il meta evento contiene l'identificatore della richiesta, la locale e la modalità.

Ogni delta contiene una parte del risultato e done contiene le informazioni sull'utilizzo.

Al termine, la connessione si chiude.

Lavorato in sincronia con i sondaggi

Invia un'intestazione Idempotency-Key univoca durante la creazione di un processo.

Creazione di endpoint

POST /api/v2/jobs

Punto di destinazione di stato

GET /api/v2/jobs/{id}

{
  "text": "Source content in the selected language.",
  "locale": "fr",
  "mode": "simple-language",
  "delivery": {
    "type": "polling"
  }
}

{
  "jobId": "job_poll_001",
  "status": "queued"
}

{
  "jobId": "job_poll_001",
  "status": "completed",
  "locale": "fr",
  "mode": "simple-language",
  "output": {
    "text": "Simplified content in French."
  }
}

I lavori rimangono disponibili per sette giorni.

Eseguire il polling a un intervallo ragionevole finché lo stato non viene completato o fallito.

Async con webhook

Crea e verifica prima un endpoint webhook nell'applicazione Simple8. Quindi fare riferimento al relativo ID endpoint nel lavoro.

Creazione di endpoint

POST /api/v2/jobs

{
  "text": "Source content in the selected language.",
  "locale": "de",
  "mode": "easy-language",
  "delivery": {
    "type": "webhook",
    "endpointId": "00000000-0000-4000-8000-000000000000"
  }
}

{
  "id": "evt_01",
  "type": "job.completed",
  "createdAt": "2026-08-06T12:00:00.000Z",
  "data": {
    "jobId": "job_hook_001",
    "status": "completed"
  }
}

Simple8 invia un'intestazione Simple8-Signature con un timestamp e una firma HMAC SHA-256.

Verifica la firma rispetto al corpo della richiesta non elaborata con il segreto della firma mostrato una volta quando viene creato l'endpoint.

Restituisce qualsiasi stato 2xx dopo aver accettato l'evento.

Le consegne non riuscite vengono ritentate fino a 50 volte nell'arco di sette giorni e i tentativi recenti sono visibili nell'applicazione.

I ricevitori devono tollerare la consegna duplicata perché i tentativi possono consegnare lo stesso evento più di una volta.

Elaborazione batch

Invia da 1 a 50 elementi con un massimo combinato di 500.000 caratteri.

Creazione di endpoint

POST /api/v2/batches

Punto di destinazione di stato

GET /api/v2/batches/{id}

Ogni elemento utilizza gli stessi campi di testo, impostazioni locali e modalità di una richiesta sincrona.

Scegli il polling o un endpoint webhook verificato per la consegna e invia un'intestazione Idempotency-Key univoca.

In questa pagina