Déan comparáid idir freagraí díreach, Streaming, comhaltaí tuairisceana agus Webhooks. Úsáidtear téacs, codáil teanga agus modh ag gach rogha.
Roghnaigh conas a fhaigheann do chóras an toradh.
{
"text": "Ábhar foinse casta sa teanga roghnaithe.",
"locale": "ga",
"mode": "simple-language"
}Samplaí SDK agus cURL ar fáil
HTTP comhtháthraithe
Críoch-aiste
POST /api/v2/translate
Is fearr le haghaidh
Teachtaireachtaí gairid a bhfuil an toradh acu ag teastáil láithreach.
Is é an rath
200 OK
Streaming
Úsáideann an freagra Ábhar-Cineál: téacs/sruth imeachtaí.
Críoch-aiste
POST /api/v2/translate/stream
Is fearr le haghaidh
Le haghaidh ábhar níos faide, ba chóir an toradh a thaispeáint céim ar chéim.
{
"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}}Tosaíonn an sruth le meta. Ansin leanann codanna téacs amháin nó níos mó mar delta.
Sa chéad imeacht tá aitheantas an iarratais, cód teanga agus mód.
Tá cuid den toradh i ngach deilt, agus tá an fhaisnéis úsáide ann.
Tar éis é a dhéanamh, dúnann an nasc.
Oibriú async le vótaíocht
Cuireann Idempotency-Key cosc ar jabanna dúblacha nuair a sheolann tú iarratas arís tar éis teorainn ama nó earráid cheangail. Roghnaigh eochair nua do gach jab nua, mar shampla UUID. Cruthaíonn tú féin an t-aitheantóir iarratais seo; ní hé d’eochair API é.
Cruthaigh ceannpoint
POST /api/v2/jobs
Staidéal deiridh
GET /api/v2/jobs/{id}
Úsáid idir 1 agus 255 carachtar: A-Z, a-z, 0-9, poncanna (.), fostríoca (_), idirstadanna (:) nó fleiscíní (-). Ná húsáid spásanna agus ná giorraigh an eochair. Le gach atriail, seol an eochair chéanna agus an corp iarratais céanna.
Tugann an chéad chruthú HTTP 202 ar ais. Má sheolann tú an t-iarratas céanna arís, faigheann tú HTTP 200 agus aitheantóir an jab atá ann cheana. Tugann an eochair chéanna le hiarratas difriúil HTTP 409 ar ais. Baineann na rialacha céanna le baisceanna. Tá an ceanntásc sna samplaí thíos; athraigh gach eochair shamplach uair amháin do gach jab nó baisc nua.
curl https://api.simple8.de/api/v2/jobs \
-H "Authorization: Bearer $SIMPLE8_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: article-4711-v1" \
-d '{
"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"
}Fanann poist ar fáil ar feadh seacht lá.
Téann jab trí queued, processing, completed nó failed. Bíonn error.code i jabanna ar theip orthu. Bíonn expiresAt i bhfreagraí cruthaithe agus stádais.
Déan an t-athbhreithniú ar an stádas arís tar éis sec. Le haghaidh próiseáil níos faide, méadú céimnithe ar an scáth.
D' oibríonn async le webhook
Cruthaigh agus fíoraigh críochphointe crúca gréasáin san fheidhmchlár Simple8 ar dtús. Ansin déan tagairt dá ID críochphointe sa phost.
Cruthaigh ceannpoint
POST /api/v2/jobs
curl https://api.simple8.de/api/v2/jobs \
-H "Authorization: Bearer $SIMPLE8_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: article-4711-webhook-v1" \
-d '{
"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"
}
}Seolann Simple8 Simple8-Signature mar t=<timestamp>,v1=<signature>. Is stampa ama Unix i soicindí é <timestamp>. Is é an síniú aschur heicsidheachúlach litreacha beaga HMAC SHA-256 thar <timestamp>.<raw request body>.
Seiceáil an síniú i gcoinne an iarratais gan athrú. Feicfidh tú an eochair sínithe rúnda uair amháin agus an críochphointe á chruthú.
Tabhair HTTP 200 nó 201 ar ais a luaithe a ghlacann do chóras leis an teagmhas.
Athsamh: Má bhíonn mícheart ann, déan iarracht an seachadadh a dhéanamh arís laistigh de seacht lá agus suas le 50 uair.
Tuairiscí dáileoghte: Déan gach aitheantas ócáide ach uair amháin, mar is féidir le athbhreithniú an t-earráid céanna a sheoladh arís.
Próiseáil bhaisc
Seol idir 1 agus 50 mír le huasmhéid comhcheangailte de 25,000 carachtar.
Cruthaigh ceannpoint
POST /api/v2/batches
Staidéal deiridh
GET /api/v2/batches/{id}
Úsáideann gach mír an téacs céanna, locale, agus réimsí mód mar iarratas sioncrónach.
Roghnaigh an vótaíocht nó críochphointe fíoraithe cluaisín gréasáin le seachadadh agus seol ceanntásc uathúil Idempotency-Key.
curl https://api.simple8.de/api/v2/batches \
-H "Authorization: Bearer $SIMPLE8_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: release-4711-v1" \
-d '{
"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"
}
}
]
}Tugann cruthú baisce HTTP 202 ar ais an chéad uair agus HTTP 200 le haghaidh athsheinm idémpotantach. Is iad na teagmhais webhook job.completed, job.failed, batch.completed agus batch.failed. Ní bhíonn ach aitheantóirí agus stádas i payloadanna webhook críochnaithe. Faigh endpoint stádais an jab nó na baisce chun an t-aschur a léamh.