added
Το μοντέλο deploy-key, όπου το bearer token ΕΙΝΑΙ το project. Είναι αυτό στο οποίο εκτελούνται τόσο το CLI όσο και το GitHub Action.
api v1 · τρέχουσα
Το αρχείο αλλαγών του API.
Καμία κατάργηση.
Το /v1 αποκτά μόνο νέα στοιχεία. Νέα endpoints και νέα πεδία απάντησης προστίθενται στο ίδιο πρόθεμα, ενώ ένα πεδίο που ήδη αναλύετε δεν αλλάζει ποτέ μορφή ή δεν εξαφανίζεται. Μια μη συμβατή αλλαγή θα κυκλοφορούσε υπό νέο πρόθεμα έκδοσης, το οποίο είναι κρατημένο και παραμένει κενό.
v1/api/v1
το μοναδικό πρόθεμα σε χρήση
το μοναδικό πρόθεμα σε χρήση
5 κυκλοφορίες
11 αλλαγές, καμία από τις οποίες δεν είναι μη συμβατή
η δομή του αρχείου καταγραφής
Ένα πρόθεμα έκδοσης, χωρίς καταργήσεις.
Τρία από αυτά τα τέσσερα είναι ιδιότητες αυτού του ίδιου του αρχείου καταγραφής. Το τέταρτο είναι το μέγεθος του καταλόγου webhook που παρέχει το API.
5
κυκλοφορίες στο /v1, όλες τους επεκτατικές
1
πρόθεμα έκδοσης σε χρήση. Το επόμενο είναι κρατημένο και κενό
0
μη συμβατές αλλαγές από την κυκλοφορία του API
12
γεγονότα webhook με υπογραφή. Πηγή: App\Enums\WebhookEvent
με ημερομηνία κυκλοφορίας, όχι με semver
χρησιμοποιήστε τα πλήκτρα βέλους για περιήγηση
2026-07-08
Παράδοση CDN, χρήση και playground
July 8, 2026 · 4 αλλαγές
05 / 05
added
Τα /v1/incontext/translations, /screenshots και /suggest οδηγούν τον οπτικό επεξεργαστή, με CORS περιορισμένο σε αυτό το πρόθεμα και τίποτα άλλο.
Το POST /v1/incontext/session ανταλλάσσει ένα publishable key και ένα Origin για ένα scoped session token.
improved
Μια δίγλωσση εξαγωγή αναφέρει πλέον τι δεν μπόρεσε να κάνει round-trip αντί να αντικαθιστά σιωπηρά το κείμενο πηγής. Τα υπάρχοντα πεδία παραμένουν αμετάβλητα, κάτι που αποτελεί τον κύριο λόγο της τοποθέτησής τους σε κεφαλίδα.
Το GET /v1/pull απέκτησε τις κεφαλίδες απόκρισης X-Skipped-Keys και X-Missing-Source-Keys.
added
Επιπλέον /v1/glossary/import, /export και /extract, ώστε η βάση όρων να μπορεί να μεταφερθεί εισερχόμενα και εξερχόμενα χωρίς άνοιγμα της κονσόλας.
Πλήρης διαχείριση CRUD βάσης όρων μέσω API: GET, POST, PUT και DELETE στο /v1/glossary.
added
Τα ευρήματα καταλήγουν στις γραμμές μετάφρασης που ήδη λαμβάνετε, οπότε δεν χρειάζεται νέα ανίχνευση.
Το POST /v1/qa/run ενεργοποιεί έναν έλεγχο ποιότητας με πράκτορα και επιστρέφει το αναγνωριστικό εκτέλεσης.
added
Εγγραφείτε ανά endpoint. Η λίστα βρίσκεται στο App\Enums\WebhookEvent, το οποίο περιέχει σήμερα δώδεκα περιπτώσεις· μετρήστε το enum αντί για αυτή τη γραμμή.
Τα υπογεγραμμένα webhooks εκπέμπουν γεγονότα κλειδιού, μετάφρασης, γλώσσας, γλωσσαρίου και QA παράλληλα με το αρχικό ζεύγος παρτίδας.
improved
Η παράδοση περιλαμβάνει έναν αριθμό και έως είκοσι δείγματα, αντί για μία κλήση ανά αλλαγμένη γραμμή. Τα αρχεία καταγραφής παράδοσης καταγράφουν κάθε προσπάθεια με την ώρα της επόμενης επανάληψης.
Τα γεγονότα υψηλής συχνότητας, όπως το translation.updated, συγχωνεύονται σε μία παράδοση ανά χρονικό παράθυρο, ώστε μια μαζική επεξεργασία να μην πλημμυρίζει ένα endpoint.
added
Επιστρέφει ένα ETag και βραχύβια cache και σέβεται το If-None-Match με 304. Ο αμετάβλητος αδελφός υπό το /v{n} έχει διεύθυνση βάσει περιεχομένου και είναι cached για ένα έτος.
Ένα δημόσιο, cacheable στο edge GET /v1/cdn/{project}/{locale} παρέχει τις δημοσιευμένες συμβολοσειρές σας.
added
Ενεργοποιήστε το στο CI με POST /v1/cdn/publish και εξουσιοδοτήστε τις αναγνώσεις με ένα αποκλειστικό κλειδί μόνο για ανάγνωση στην κεφαλίδα X-Transglot-Cdn-Key. Ασφαλές για χρήση πίσω από το δικό σας CDN.
Η δημοσίευση προωθεί τις τρέχουσες μεταφράσεις σε μια νέα αμετάβλητη έκδοση, χειροκίνητα ή σε κάθε push.
added
Δεν αποθηκεύονται σώματα αιτημάτων. Είναι απλώς ένας αριθμός και τίποτε άλλο.
Κάθε authenticated κλήση /v1 μετριέται ανά token ανά ημέρα και εμφανίζεται στο hub ανάπτυξης.
improved
Project, pull, batches και export γλωσσαρίου. Δεν άλλαξε σχήμα αιτήματος ή απόκρισης για να λειτουργήσει.
Το hub ανάπτυξης απέκτησε ένα API playground που εκτελεί live endpoints μόνο για ανάγνωση σε σχέση με το project σας.
μητρώο deprecation
Τίποτε δεν θα αποσυρθεί.
Μία γραμμή ανά δημοσιευμένη επιφάνεια, με την έκδοση που την περιλάμβανε. Η τελευταία στήλη είναι αυτή που πρέπει να παρακολουθείτε: μια κατάργηση θα εμφανιζόταν εκεί με ημερομηνία πολύ πριν συμβεί.
| Επιφάνεια | Κυκλοφόρησε | Κατάσταση | Ημερομηνία κατάργησης |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | τρέχον | καμία προγραμματισμένη |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | τρέχον | καμία προγραμματισμένη |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | τρέχον | καμία προγραμματισμένη |
POST /v1/qa/run | June 12, 2026 | τρέχον | καμία προγραμματισμένη |
Signed webhook events, twelve typed cases | June 30, 2026 | τρέχον | καμία προγραμματισμένη |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | τρέχον | καμία προγραμματισμένη |
Μια γραμμή δεν διαγράφεται ποτέ από αυτόν τον πίνακα. Εάν μια επιφάνεια αποσυρθεί, διατηρεί τη γραμμή της και αποκτά μια ημερομηνία, επειδή μια κατάργηση για την οποία μπορείτε να σχεδιάσετε εκ των προτέρων είναι ο κύριος λόγος δημοσίευσης.
η υπόσχεση συμβατότητας
Τρεις κανόνες στο οποίο μπορείτε να βασιστείτε.
προσθετικό
Νέα τελικά σημεία και νέα πεδία απάντησης κυκλοφορούν μέσα στο /v1. Ένα πεδίο που ήδη αναλύετε δεν αλλάζει δομή και δεν εξαφανίζεται.
νέο πρόθεμα
A breaking change would ship under a new version prefix rather than inside this one. That prefix is reserved and unused, and every release above landed on v1.
ειλικρινείς κεφαλίδες
Όταν ένα pull δεν μπορεί να ολοκληρώσει έναν κύκλο μετατροπής, το αναφέρει σε μια κεφαλίδα. Προστέθηκαν οι κεφαλίδες X-Skipped-Keys και X-Missing-Source-Keys αντί να αλλάξει το σώμα της απάντησης χωρίς προειδοποίηση.
Συχνές ερωτήσεις
Απαντήσεις σε ερωτήσεις που θέτουν οι προγραμματιστές σχετικά με την έκδοση και τη σταδιακή κατάργηση του API.
Υποστηρίζει το Transglot API διαχείριση εκδόσεων;
Ναι, μέσω προθέματος URL. Όλα όσα έχουν δημοσιευτεί μέχρι στιγμής βρίσκονται υπό το /v1, το οποίο είναι το μόνο πρόθεμα που χρησιμοποιείται. Δεν υπάρχει κεφαλίδα έκδοσης, δεν γίνεται δέσμευση με ημερομηνία και δεν απαιτείται κάποια ρύθμιση.
Μπορεί μια ενημέρωση να διακόψει ποτέ την ενσωμάτωσή μου;
Όχι εντός του /v1. Προστίθενται νέα endpoints και νέα πεδία απάντησης, αλλά ένα πεδίο που ήδη αναλύετε δεν αλλάζει δομή και δεν εξαφανίζεται. Εάν μια αλλαγή δεν μπορεί να γίνει προσθετικά, θα υλοποιηθεί υπό νέο πρόθεμα και το παλιό θα συνεχίσει να λειτουργεί.
Έχει καταργηθεί ή αφαιρεθεί κάτι;
Τίποτα, και το παραπάνω μητρώο το επιβεβαιώνει γραμμή προς γραμμή. Κάθε δημοσιευμένη επιφάνεια παρατίθεται με την έκδοση κυκλοφορίας της και μια στήλη κατάργησης που προς το παρόν αναφέρει «καμία προγραμματισμένη» σε όλες τις γραμμές.
Πόση προειδοποίηση θα λαμβάναμε πριν από μια κατάργηση;
Μια κατάργηση θα εμφανιζόταν σε αυτό το μητρώο με μια ημερομηνία πολύ πριν πραγματοποιηθεί και η γραμμή θα παρέμενε στον πίνακα και μετά, αντί να εξαφανιστεί. Ο σκοπός της δημοσίευσης μιας τέτοιας ημερομηνίας είναι ακριβώς να μπορείτε να σχεδιάσετε ανάλογα.
Πώς μπορώ να μάθω πότε κυκλοφορεί κάτι νέο;
Κάθε έκδοση έχει ημερομηνία σε αυτή τη σελίδα. Το changelog του προϊόντος καλύπτει όλα τα υπόλοιπα που κυκλοφορούν και η κονσόλα εμφανίζει μια ένδειξη όταν υπάρχει κάτι που δεν έχετε διαβάσει.
Γιατί υπάρχει ξεχωριστό changelog για το API;
Επειδή το API περιλαμβάνει μια υπόσχεση συμβατότητας που δεν ισχύει για μια κυκλοφορία προϊόντος. Ένας προγραμματιστής που ελέγχει εάν μια ενσωμάτωση λειτουργεί ακόμα δεν θα πρέπει να χρειάζεται να κάνει κύλιση past εργασίες νέων λειτουργιών για να το διαπιστώσει.
Πώς μπορώ να προσθέσω το API στο πρόγραμμά μου;
Ένα bearer token ξεκινά από το πρόγραμμα Starter στα $19 τον μήνα. Το δωρεάν πρόγραμμα καλύπτει την κονσόλα αλλά δεν επιτρέπει τη δημιουργία token, ενώ το CLI, το GitHub Action, τα webhooks και το MCP απαιτούν όλα αυτό το ίδιο token.
Πού βρίσκεται η αναφορά για τα ίδια τα endpoints;
Στη σελίδα API: έλεγχος ταυτότητας, τα endpoints, το όριο αιτημάτων, οι μορφές αρχείων και ο κατάλογος webhooks. Αυτή η σελίδα είναι μόνο το αρχείο των αλλαγών και του χρόνου τους.
λειτουργεί με όσα ήδη χρησιμοποιείτε
41 συνδέσεις, έτοιμες προς χρήση.
το συμβόλαιο είναι το προϊόν
Δημιουργήστε με ένα API που δεν μεταβάλλεται.
Το API διατίθεται στο Starter και άνω. Το δωρεάν πρόγραμμα κοστίζει $0 με 100.000 λέξεις για ξεκίνημα (25.000 κατά την εγγραφή, 75.000 μετά από τηλεφωνική επαλήθευση), 10.000 τον μήνα στη συνέχεια, και χωρίς πρόσβαση σε API ή webhooks.