Συγκρίνετε τις απλές απαντήσεις, Streaming, τις εντολές από το υπόβαθρο και Webhooks.
Επιλέξτε πώς το σύστημα σας λαμβάνει το αποτέλεσμα.
{
"text": "Σύνθετο περιεχόμενο πηγής στην επιλεγμένη γλώσσα.",
"locale": "el",
"mode": "simple-language"
}Διαθέσιμα παραδείγματα SDK και cURL
Συγχρονισμένο HTTP
Τελικός πίνακας
POST /api/v2/translate
Καλύτερα για
Σύντομοι κείμενοι, τα αποτελέσματα των οποίων θα χρησιμοποιηθούν αμέσως.
Επιτυχία
200 ΟΚ
Διαστροφή
Η απάντηση χρησιμοποιεί Τύπος περιεχομένου: κείμενο/ροή συμβάντος.
Τελικός πίνακας
POST /api/v2/translate/stream
Καλύτερα για
Για μεγαλύτερο περιεχόμενο, το αποτέλεσμα του οποίου θα πρέπει να εμφανίζεται βήμα προς βήμα.
{
"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}}Το ρεύμα ξεκινά με το meta. Μετά ακολουθούν ένα ή περισσότερα κομμάτια κειμένου ως delta.
Το πρώτο συμβάν περιέχει το αναγνωριστικό αιτήματος, τον κωδικό γλώσσας και τη λειτουργία.
Κάθε δέλτα περιέχει ένα μέρος του αποτελέσματος και το done περιέχει τις πληροφορίες χρήσης.
Αφού γίνει, η σύνδεση κλείνει.
Ασύγχρονη εργασία με τις δημοσκοπήσεις
Στείλτε μια μοναδική κεφαλίδα Idempotency-Key κατά τη δημιουργία μιας εργασίας. Για νέες προσπάθειες, χρησιμοποιήστε το ίδιο κλειδί χωρίς αρχικά ή τελικά κενά, με μήκος από 1 έως 255 χαρακτήρες. Η πρώτη δημιουργία επιστρέφει 202, ενώ η επανάληψη επιστρέφει 200.
Δημιουργία τελικού σημείου
POST /api/v2/jobs
Κινέζικο σημείο καταστάσεως
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"
}Οι θέσεις εργασίας παραμένουν διαθέσιμες για επτά ημέρες.
Μια εργασία περνά από τις καταστάσεις queued, processing, completed ή failed. Οι αποτυχημένες εργασίες περιλαμβάνουν error.code. Οι αποκρίσεις δημιουργίας και κατάστασης περιλαμβάνουν expiresAt.
Επανέλαβε την κατάσταση πρώτα μετά από ένα δευτερόλεπτο.
Ασύγχρονση εργασίας με webhook
Δημιουργήστε και επαληθεύστε πρώτα ένα τελικό σημείο webhook στην εφαρμογή Simple8. Στη συνέχεια, αναφέρετε το αναγνωριστικό τελικού σημείου στην εργασία.
Δημιουργία τελικού σημείου
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 στέλνει το Simple8-Signature ως t=<timestamp>,v1=<signature>. Το <timestamp> είναι χρονική σήμανση Unix σε δευτερόλεπτα. Η υπογραφή είναι η δεκαεξαδική έξοδος με πεζά γράμματα ενός HMAC SHA-256 επί του <timestamp>.<raw request body>.
Ελέγξτε την υπογραφή σε σχέση με το αμετάβλητο αίτημα. Θα δείτε το μυστικό κλειδί υπογραφής μία φορά κατά τη δημιουργία του τελικού σημείου.
Επιστρέψτε HTTP 200 ή 201 μόλις το σύστημά σας αποδεχτεί το συμβάν.
Επαναλαμβανόμενα: Σε περίπτωση σφάλματος, η αποστολή δοκιμάζεται επτά φορές μέσα σε επτά ημέρες έως και 50 φορές.
Δύο γεγονότα: Επεξεργαστείτε κάθε αναγνωριστικό γεγονότος μόνο μία φορά, καθώς μια επανάληψη μπορεί να στείλει το ίδιο γεγονός ξανά.
Επεξεργασία παρτίδας
Στείλτε από 1 έως 50 στοιχεία με συνολικό μέγιστο 25.000 χαρακτήρες.
Δημιουργία τελικού σημείου
POST /api/v2/batches
Κινέζικο σημείο καταστάσεως
GET /api/v2/batches/{id}
Κάθε στοιχείο χρησιμοποιεί τα ίδια πεδία κειμένου, τοπικής ρύθμισης και λειτουργίας ως σύγχρονο αίτημα.
Επιλέξτε ψηφοφορία ή ένα επαληθευμένο τελικό σημείο webhook για παράδοση και στείλτε μια μοναδική κεφαλίδα 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"
}
}
]
}Η δημιουργία παρτίδας επιστρέφει HTTP 202 την πρώτη φορά και HTTP 200 σε ιδιοδύναμη επανάληψη. Τα συμβάντα webhook είναι job.completed, job.failed, batch.completed και batch.failed. Τα payload ολοκληρωμένων webhook περιέχουν μόνο αναγνωριστικά και κατάσταση. Ανακτήστε το αποτέλεσμα από το endpoint κατάστασης της εργασίας ή της παρτίδας.