Συγκρίνετε τις απλές απαντήσεις, 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 αποτρέπει διπλές εργασίες όταν στέλνετε ξανά ένα αίτημα μετά από λήξη χρονικού ορίου ή σφάλμα σύνδεσης. Επιλέξτε νέο κλειδί για κάθε νέα εργασία, για παράδειγμα ένα UUID. Δημιουργείτε εσείς αυτό το αναγνωριστικό αιτήματος· δεν είναι το κλειδί API σας.
Δημιουργία τελικού σημείου
POST /api/v2/jobs
Κινέζικο σημείο καταστάσεως
GET /api/v2/jobs/{id}
Χρησιμοποιήστε 1 έως 255 χαρακτήρες: A-Z, a-z, 0-9, τελείες (.), κάτω παύλες (_), άνω και κάτω τελείες (:) ή παύλες (-). Μη χρησιμοποιείτε κενά και μη συντομεύετε το κλειδί. Σε κάθε επανάληψη, στείλτε το ίδιο κλειδί και το ίδιο σώμα αιτήματος.
Η πρώτη δημιουργία επιστρέφει HTTP 202. Η επανάληψη του ίδιου αιτήματος επιστρέφει HTTP 200 με το ID της υπάρχουσας εργασίας. Το ίδιο κλειδί με διαφορετικό αίτημα επιστρέφει HTTP 409. Οι ίδιοι κανόνες ισχύουν για τις παρτίδες. Τα παρακάτω παραδείγματα περιλαμβάνουν την κεφαλίδα· αντικαταστήστε κάθε ενδεικτικό κλειδί μία φορά για κάθε νέα εργασία ή παρτίδα.
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"
}Οι θέσεις εργασίας παραμένουν διαθέσιμες για επτά ημέρες.
Μια εργασία περνά από τις καταστάσεις queued, processing, completed ή failed. Οι αποτυχημένες εργασίες περιλαμβάνουν error.code. Οι αποκρίσεις δημιουργίας και κατάστασης περιλαμβάνουν expiresAt.
Επανέλαβε την κατάσταση πρώτα μετά από ένα δευτερόλεπτο.
Ασύγχρονση εργασίας με webhook
Δημιουργήστε και επαληθεύστε πρώτα ένα τελικό σημείο webhook στην εφαρμογή Simple8. Στη συνέχεια, αναφέρετε το αναγνωριστικό τελικού σημείου στην εργασία.
Δημιουργία τελικού σημείου
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"
}
}Το 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.
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"
}
}
]
}Η δημιουργία παρτίδας επιστρέφει HTTP 202 την πρώτη φορά και HTTP 200 σε ιδιοδύναμη επανάληψη. Τα συμβάντα webhook είναι job.completed, job.failed, batch.completed και batch.failed. Τα payload ολοκληρωμένων webhook περιέχουν μόνο αναγνωριστικά και κατάσταση. Ανακτήστε το αποτέλεσμα από το endpoint κατάστασης της εργασίας ή της παρτίδας.