Comparați răspunsuri directe, streaming, locuri de muncă de fundal, și site-uri web. Toate variantele folosesc text, cod lingvistic și mod.
Alegeţi cum va primi sistemul rezultatul.
{
"text": "Conținut sursă complex în limba selectată.",
"locale": "ro",
"mode": "simple-language"
}Sunt disponibile exemple SDK și cURL
HTTP sincronic
Punctul final
POST /api/v2/translate
Cel mai bun pentru
Texte scurte, al căror rezultat este necesar imediat.
Succesul
200 OK
Streaming
Răspunsul folosește Content-Type: text/event-stream.
Punctul final
POST /api/v2/translate/stream
Cel mai bun pentru
Pentru un conținut mai lung, al cărui rezultat trebuie afișat treptat.
{
"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}}Fluxul începe cu meta. Aceasta este urmată de una sau mai multe părți ale textului ca delta. Evenimentul realizat completează răspunsul cu datele de utilizare.
Primul eveniment conține ID-ul cererii, codul vocal și modul.
Fiecare deltă conține o parte a rezultatului și done conține informațiile de utilizare.
După terminare, conexiunea se închide.
Lucrarea de sincronizare cu sondajele
Trimiteți un antet unic Idempotency-Key atunci când creați o sarcină. Pentru reîncercări, utilizați aceeași cheie fără spații la început sau la sfârșit, cu o lungime de 1 până la 255 de caractere. Prima creare returnează 202, iar repetarea returnează 200.
Creează un punct de destinație
POST /api/v2/jobs
Puncte de final de stat
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",
"expiresAt": "2026-09-03T12:00:00.000Z"
}{
"jobId": "job_poll_001",
"status": "completed",
"locale": "fr",
"mode": "simple-language",
"output": "Simplified content in French.",
"expiresAt": "2026-09-03T12:00:00.000Z"
}Locurile de muncă rămân disponibile timp de șapte zile.
O sarcină trece prin stările queued, processing, completed sau failed. Sarcinile nereușite includ error.code. Răspunsurile de creare și de stare includ expiresAt.
Mai întâi cere statutul după o secundă. Creșteți distanța treptat cu procesare mai lungă.
Lucrarea de sincronizare cu webhook
Creați și verificați mai întâi un punct final webhook în aplicația Simple8. Apoi faceți referire la ID-ul punctului final în job.
Creează un punct de destinație
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 trimite Simple8-Signature în formatul t=<timestamp>,v1=<signature>. <timestamp> este un marcaj temporal Unix exprimat în secunde. Semnătura este rezultatul hexazecimal cu litere mici al unui HMAC SHA-256 calculat pentru <timestamp>.<raw request body>.
Verificați semnătura împotriva cererii neschimbate. Veți vedea cheia semnătură secretă odată ce creați obiectivul.
Returnează HTTP 200 sau 201 imediat ce sistemul tău acceptă evenimentul.
Repetă: În caz de eroare, Simple8 încearcă livrarea până la 50 de ori în termen de șapte zile. Puteți vedea ultimele încercări în aplicație.
Duplicate evenimente: Procesați fiecare ID de eveniment o singură dată, deoarece o repetare poate retrimite același eveniment.
Prelucrare în lot
Trimiteți între 1 și 50 de articole cu un maxim combinat de 25.000 de caractere.
Creează un punct de destinație
POST /api/v2/batches
Puncte de final de stat
GET /api/v2/batches/{id}
Fiecare articol utilizează aceleași câmpuri de text, locale și mod ca o solicitare sincronă.
Alegeți sondajul sau un punct final de webhook verificat pentru livrare și trimiteți un antet unic Idempotency-Key.
{
"items": [
{
"text": "First source text.",
"locale": "en",
"mode": "simple-language"
},
{
"text": "Second source text.",
"locale": "de",
"mode": "easy-language"
}
],
"delivery": {
"type": "polling"
}
}{
"batchId": "batch_001",
"status": "queued",
"itemCount": 2
}{
"batchId": "batch_001",
"status": "completed",
"itemCount": 2,
"items": [
{
"jobId": "job_001",
"status": "completed",
"locale": "en",
"mode": "simple-language",
"output": "First result."
},
{
"jobId": "job_002",
"status": "failed",
"locale": "de",
"mode": "easy-language",
"error": {
"code": "processing_failed"
}
}
]
}Crearea unui lot returnează HTTP 202 prima dată și HTTP 200 la o repetare idempotentă. Evenimentele webhook sunt job.completed, job.failed, batch.completed și batch.failed. Payloadurile webhookurilor finalizate conțin numai identificatori și starea. Preia rezultatul din endpointul de stare al sarcinii sau lotului.