Τεκμηρίωση

Επιλέξτε πώς το σύστημα σας λαμβάνει το αποτέλεσμα.

{
  "text": "Σύνθετο περιεχόμενο πηγής στην επιλεγμένη γλώσσα.",
  "locale": "el",
  "mode": "simple-language"
}

Διαθέσιμα παραδείγματα SDK και cURL

Συγχρονισμένο HTTP

Κάθε μοτίβο χρησιμοποιεί τα ίδια βασικά πεδία: κείμενο, τοπική ρύθμιση και λειτουργία.

Τελικός πίνακας

POST /api/v2/translate

Καλύτερα για

Κρατικό περιεχόμενο και άμεσες πράξεις backend.

Επιτυχία

200 ΟΚ

Διαστροφή

Η απάντηση χρησιμοποιεί Τύπος περιεχομένου: κείμενο/ροή συμβάντος.

Τελικός πίνακας

POST /api/v2/translate/stream

Καλύτερα για

Προχωρητικές διεπαφές και μεγαλύτερο περιεχόμενο.

json
{
  "text": "Source content in the selected language.",
  "locale": "en",
  "mode": "easy-language"
}
text
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}}

Η ροή εκπέμπει ένα μετα-συμβάν, ένα ή περισσότερα συμβάντα δέλτα και ένα τελικό ολοκληρωμένο συμβάν.

Το μετα-συμβάν περιέχει το αναγνωριστικό αιτήματος, τις τοπικές ρυθμίσεις και τη λειτουργία.

Κάθε δέλτα περιέχει ένα μέρος του αποτελέσματος και το done περιέχει τις πληροφορίες χρήσης.

Αφού γίνει, η σύνδεση κλείνει.

Ασύγχρονη εργασία με τις δημοσκοπήσεις

Στείλτε μια μοναδική κεφαλίδα Idempotency-Key κατά τη δημιουργία μιας εργασίας.

Δημιουργία τελικού σημείου

POST /api/v2/jobs

Κινέζικο σημείο καταστάσεως

GET /api/v2/jobs/{id}

json
{
  "text": "Source content in the selected language.",
  "locale": "fr",
  "mode": "simple-language",
  "delivery": {
    "type": "polling"
  }
}
json
{
  "jobId": "job_poll_001",
  "status": "queued"
}
json
{
  "jobId": "job_poll_001",
  "status": "completed",
  "locale": "fr",
  "mode": "simple-language",
  "output": {
    "text": "Simplified content in French."
  }
}

Οι θέσεις εργασίας παραμένουν διαθέσιμες για επτά ημέρες.

Δημοσκόπηση σε εύλογο διάστημα μέχρι να ολοκληρωθεί ή να αποτύχει η κατάσταση.

Ασύγχρονση εργασίας με webhook

Δημιουργήστε και επαληθεύστε πρώτα ένα τελικό σημείο webhook στην εφαρμογή Simple8. Στη συνέχεια, αναφέρετε το αναγνωριστικό τελικού σημείου στην εργασία.

Δημιουργία τελικού σημείου

POST /api/v2/jobs

json
{
  "text": "Source content in the selected language.",
  "locale": "de",
  "mode": "easy-language",
  "delivery": {
    "type": "webhook",
    "endpointId": "00000000-0000-4000-8000-000000000000"
  }
}
json
{
  "id": "evt_01",
  "type": "job.completed",
  "createdAt": "2026-08-06T12:00:00.000Z",
  "data": {
    "jobId": "job_hook_001",
    "status": "completed"
  }
}

Το Simple8 στέλνει μια κεφαλίδα Simple8-Signature με χρονική σήμανση και υπογραφή HMAC SHA-256.

Επαληθεύστε την υπογραφή στο σώμα του πρωτογενούς αιτήματος με το μυστικό υπογραφής να εμφανίζεται μία φορά όταν δημιουργείται το τελικό σημείο.

Επιστρέψτε οποιαδήποτε κατάσταση 2xx μετά την αποδοχή του συμβάντος.

Οι αποτυχημένες παραδόσεις δοκιμάζονται ξανά έως και 50 φορές σε επτά ημέρες και οι πρόσφατες προσπάθειες είναι ορατές στην εφαρμογή.

Οι παραλήπτες πρέπει να ανέχονται διπλότυπη παράδοση, επειδή οι επαναλήψεις μπορούν να παραδώσουν το ίδιο συμβάν περισσότερες από μία φορές.

Επεξεργασία παρτίδας

Στείλτε από 1 έως 50 στοιχεία με συνολικό μέγιστο 500.000 χαρακτήρες.

Δημιουργία τελικού σημείου

POST /api/v2/batches

Κινέζικο σημείο καταστάσεως

GET /api/v2/batches/{id}

Κάθε στοιχείο χρησιμοποιεί τα ίδια πεδία κειμένου, τοπικής ρύθμισης και λειτουργίας ως σύγχρονο αίτημα.

Επιλέξτε ψηφοφορία ή ένα επαληθευμένο τελικό σημείο webhook για παράδοση και στείλτε μια μοναδική κεφαλίδα Idempotency-Key.