api.transglot.ai/v1διακριτικό bearer, ένα έργοαναφορά

Ανεβάστε ένα αρχείο. Λάβετε πίσω κάθε γλώσσα.

Ένα REST API για τη μετάφραση της εφαρμογής σας. Μία αίτηση POST ανεβάζει το αρχείο προέλευσης, μία αίτηση GET επιστρέφει μια ολοκληρωμένη τοπική ρύθμιση και ένα διακριτικό bearer αποτελεί ολόκληρη τη διαδικασία ελέγχου ταυτότητας. Οποιοδήποτε σύστημα που υποστηρίζει HTTP μπορεί να το χρησιμοποιήσει.

σε: μία κλήση

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

έξοδος

300,000

λέξεις τον μήνα στο Starter, το πρώτο πρόγραμμα που μπορεί να δημιουργήσει διακριτικό.

Ξεκινήστε δωρεάν Δείτε την επιφάνεια για προγραμματιστές

60 αιτήσεις ανά λεπτό ανά διακριτικό · κάθε απόκριση 429 περιλαμβάνει κεφαλίδα Retry-After · χρησιμοποιήστε ξεχωριστά διακριτικά για CI και παραγωγή

η κονσόλα είναι ένας πελάτης API

Ανέβασμα, μετάφραση, έλεγχος ποιότητας και λήψη, κάθε ένα ως τελικό σημείο REST.

Κάθε γραμμή στην παρακάτω εικόνα έχει μια διαδρομή πίσω της: ανέβασμα, έλεγχοι ποιότητας, γλωσσάριο, παρτίδες και λήψη, όλα προσβάσιμα από τον δικό σας κώδικα με ένα διακριτικό έργου. Το περιβάλλον δοκιμών API στην κονσόλα εκτελεί ζωντανά τις λειτουργίες μόνο για ανάγνωση στο έργο σας, ώστε να δείτε πρώτα μια πραγματική απόκριση.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Ανεβάζετε ένα αρχείο προέλευσης
POST/v1/push
Ο πίνακας ελέγχων ποιότητας συμπληρώνεται
POST/v1/qa/run
Κλειδώνετε έναν όρο
POST/v1/glossary
Η προβολή παρτίδας κάνει polling στον εαυτό της
GET/v1/batches/:id
Ανακτάτε τις μεταφράσεις
GET/v1/pull

μία διαδρομή ανά πίνακα, 60 το λεπτό, δυνατότητες ανά token · η εξαγωγή των μεταφράσεών σας είναι επίσης ένα endpoint

είναι απλώς http

Τέσσερα πράγματα που οι ομάδες φτιάχνουν πρώτα.

κάθε ένα είναι ένα μοναδικό endpoint και ένα project token · κανένα δεν απαιτεί ολόκληρο απόγευμα

πύλη συγχώνευσης · ένα αρχείο ροής εργασίας

Μετατρέψτε το pull request σε κόκκινο όταν αποτύχει μια μετάφραση.

cron · κάθε βράδυ

Μεταφράστε τις σημειώσεις έκδοσης κατά τη διάρκεια της νύχτας, κάθε βράδυ.

bot · μία συνδρομή

Δημοσιεύστε στο Slack τη στιγμή που ολοκληρώνεται μια παρτίδα.

agent · mcp

Δώστε σε έναν πράκτορα AI τα ίδια 17 εργαλεία που έχετε.

αιτήματα το λεπτό

ανά token, όχι ανά λογαριασμό, με κεφαλίδα Retry-After σε κάθε 429 που αναφέρει πόσα δευτερόλεπτα να περιμένετε.

μορφές αρχείων

στείλτε και ανακτήστε τη μορφή που χρησιμοποιεί ήδη το αποθετήριό σας. Τα πληθυντικά και τα placeholders διατηρούνται και στις δύο κατευθύνσεις. Ορίστε το με format= σε οποιαδήποτε κλήση.

γεγονότα webhook

ολόκληρος ο κατάλογος, καθένα με ένα παράδειγμα payload στην ακριβή μορφή μιας πραγματικής παράδοσης. GET /v1/webhooks/events.

εργαλεία mcp

το ίδιο project token, παραδίδεται σε ένα runtime agent αντί για curl. npx -y @transglot/mcp.

Συχνές Ερωτήσεις

Τι ρωτούν οι προγραμματιστές πριν από το πρώτο αίτημα.

Πώς κάνω αυθεντικοποίηση με το Transglot API;

Στείλτε ένα bearer token: Authorization: Bearer $TRANSGLOT_TOKEN. Το token ανήκει σε ένα project, επομένως δεν υπάρχει project id στη διαδρομή και κανένα κλειδί για ολόκληρο τον λογαριασμό που θα μπορούσε να διαρρεύσει. Δημιουργείτε tokens στη σελίδα του project και το καθένα έχει τις δικές του δυνατότητες: push, pull, manage, read, write.

Είναι δωρεάν το API;

Όχι. Ένα bearer token ξεκινά από το πρόγραμμα Starter στα 19$ το μήνα. Η δωρεάν έκδοση καλύπτει την κονσόλα, η οποία αρκεί για να δείτε αν το προϊόν ταιριάζει στις ανάγκες σας, αλλά δεν μπορεί να δημιουργήσει token. Το CLI, το GitHub Action, τα webhooks, το MCP και το πακέτο παράδοσης βρίσκονται όλα πίσω από το ίδιο token, έτσι έρχονται μαζί.

Πώς ανεβάζω συμβολοσειρές στο Transglot;

POST /v1/push με το αρχείο και τη μορφή του, για παράδειγμα -F "file=@lang/en.json" -F "format=laravel_json". Επιστρέφει 202 και προσθέτει μια παρτίδα στην ουρά. Μεταφράζονται μόνο οι γραμμές που έχουν πραγματικά αλλάξει, οπότε η αποστολή ενός αμετάβλητου αρχείου δεν έχει κόστος.

Πώς μπορώ να ανακτήσω τις μεταφράσεις μου;

GET /v1/pull, σε οποιαδήποτε από τις 20 μορφές, όποτε θέλετε. Είναι το endpoint που περικλείει το CLI και αυτό που εκτελεί ζωντανά το API playground. Δεν υπάρχει αίτημα εξαγωγής σε αρχείο ούτε χρονικό διάστημα κατά το οποίο τα δεδομένα παύουν να είναι δικά σας.

Ποιο είναι το όριο αιτημάτων του API;

60 αιτήματα ανά λεπτό, υπολογιζόμενα ανά token και όχι ανά λογαριασμό. Σε περίπτωση υπέρβασης, λαμβάνετε σφάλμα 429 με κεφαλίδα Retry-After που υποδεικνύει πόσα δευτερόλεπτα πρέπει να περιμένετε, χωρίς χρέωση ή ημιτελή εγγραφή. Χρησιμοποιήστε ξεχωριστά tokens για το CI και την παραγωγή, ώστε μια θορυβώδης build να μην στερεί πόρους από την εφαρμογή σας.

Ποιες γλώσσες υποστηρίζει το API;

Δεν υπάρχει σταθερή λίστα. Ο επικυρωτής αποδέχεται οποιαδήποτε ετικέτα BCP-47 αναγνωρίζει το ICU, δηλαδή 708 τοπικές ρυθμίσεις στον πίνακα ελέγχου, plus δομική επαναφορά για ετικέτες εκτός αυτού. Προσθέστε μια τοπική ρύθμιση στο έργο και η επόμενη αποστολή θα την περιλαμβάνει.

Ποιες μορφές αρχείων μπορώ να αποστείλω και να ανακτήσω;

Είκοσι: JSON flat και nested, Laravel PHP και JSON, Android XML, iOS .strings, .stringsdict και .xcstrings, Flutter ARB, XLIFF 1.2 και 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV και Unreal PO. Επτά από αυτές υποστηρίζουν πληθυντικούς αριθμούς και το αρχείο επιστρέφει στην ίδια δομή με την οποία απεστάλη.

Υποστηρίζει το Transglot webhooks;

Ναι. Υπάρχουν 12 γεγονότα webhook, συμπεριλαμβανομένων των batch.completed, translation.reviewed, qa.completed και source_drift.repaired. Κάθε παράδοση είναι υπογεγραμμένη με HMAC με κεφαλίδα χρονικής σήμανσης, ώστε να μπορείτε να την επαληθεύσετε, και το GET /v1/webhooks/events επιστρέφει τον κατάλογο με ένα δείγμα payload για καθένα.

Υπάρχει διακομιστής MCP για agents AI;

Ναι. Το npx -y @transglot/mcp εκθέτει 17 εργαλεία μέσω του διακριτικού του έργου σας, ώστε ένας βοηθός να μπορεί να διαβάσει μια μετάφραση, να γράψει μία, να προσθέσει μια γλώσσα, να ξεκινήσει μια εκτέλεση, να ελέγξει μια παρτίδα ή να επεξεργαστεί το γλωσσάριο. Είναι το ίδιο API και οι ίδιες άδειες, προσβάσιμες από έναν χρόνο εκτέλεσης πράκτορα αντί από curl.

Μπορώ να το εκτελέσω σε CI;

Ναι. Η ενέργεια GitHub (transglot/transglot-action@v1) και το CLI περιτυλίγουν αυτά τα τελικά σημεία. Όταν μια γραμμή απορρίπτεται, η εντολή transglot push --wait τερματίζει με κωδικό 4 και η ενέργεια αποτυγχάνει την εργασία της σε αυτή την εκτέλεση. Για να σταματήσετε μια συγχώνευση, εκτελέστε την σε αιτήματα pull με την είσοδο commit ορισμένη σε none, προσθέστε ένα βήμα που αποτυγχάνει όταν σε ένα αρχείο που έχει ληφθεί λείπει ένα κλειδί και ορίστε την εργασία ως απαιτούμενο έλεγχο στην προστασία κλάδου.

Τι συμβαίνει όταν μια μετάφραση αποτυγχάνει σε έλεγχο ποιότητας;

Τέσσερις καθοριστικές πύλες διαβάζουν κάθε γραμμή: σύμβολα κράτησης θέσης, πληθυντικούς αριθμούς, όρους γλωσσαρίου και μήκος. Ένα κατεστραμμένο σύμβολο κράτησης θέσης, μια missing plural form ή ένας απαγορευμένος όρος γλωσσαρίου λαμβάνει μία αυτόματη διορθωτική επανάληψη και, εάν εξακολουθεί να αποτυγχάνει, η γραμμή απορρίπτεται αντί να γραφτεί. Μια γραμμή που μόνο υπερβαίνει το μήκος της γράφεται, δεν απορρίπτεται. Το GET /v1/batches/:id?include=failures παραθέτει τις απορριφθείσες γραμμές και τον λόγο.

Will the API ever break my integration?

No. /v1 only ever gains endpoints and response fields; a field you already parse does not change shape or disappear. A breaking change would ship under a new version prefix, which is reserved and still empty. The API changelog records every release.

λειτουργεί με όσα ήδη χρησιμοποιείτε