api.transglot.ai/v1token bearer, jeden projektdokumentacja

Wyślij plik. Otrzymaj wszystkie języki z powrotem.

REST API do tłumaczenia Twojej aplikacji. Jedno żądanie POST przesyła plik źródłowy, jedno GET zwraca gotową lokalizację, a token bearer stanowi całe uwierzytelnienie. Może z niego korzystać każde narzędzie obsługujące HTTP.

wejście: jedno wywołanie

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

wyjście

300,000

słów miesięcznie w planie Starter, pierwszy plan umożliwiający generowanie tokenów.

Zacznij za darmo Zobacz interfejs dla deweloperów

60 żądań na minutę na token · każdy kod 429 zawiera nagłówek Retry-After · używaj osobnych tokenów dla CI i produkcji

konsola to klient API

Wysyłaj, tłumacz, weryfikuj i pobieraj, każda operacja to osobny endpoint REST.

Każdy wiersz na poniższym obrazku ma przypisaną trasę: wysyłanie, weryfikacje, glosariusz, partie i pobieranie — wszystkie dostępne z poziomu własnego kodu przy użyciu tokena projektu. Piaskownica API w konsoli uruchamia operacje tylko do odczytu na żywo w Twoim projekcie, dzięki czemu najpierw widzisz rzeczywistą odpowiedź.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Przesyłasz plik źródłowy
POST/v1/push
Panel weryfikacji wypełnia się
POST/v1/qa/run
Blokujesz termin
POST/v1/glossary
Widok partii samoczynnie odpytuje status
GET/v1/batches/:id
Pobierasz tłumaczenia z powrotem
GET/v1/pull

jedna trasa na panel, 60 na minutę, uprawnienia per token · eksport tłumaczeń również odbywa się przez endpoint

to po prostu HTTP

Cztery rzeczy, które zespoły budują jako pierwsze.

każda to pojedynczy endpoint i token projektu · żadna nie zajmuje całego popołudnia

bramka scalania · jeden plik przepływu pracy

Oznacz pull request na czerwono, gdy tłumaczenie nie przejdzie weryfikacji.

cron · co noc

Tłumacz informacje o wydaniu w nocy, każdej nocy.

bot · jedna subskrypcja

Opublikuj wiadomość na Slacku w momencie zakończenia partii.

agent · MCP

Daj agentowi AI te same 17 narzędzi, z których korzystasz.

żądań na minutę

per token, nie per konto, z nagłówkiem Retry-After przy każdym kodzie 429, informującym o liczbie sekund oczekiwania.

formaty plików

wysyłaj i pobieraj w formacie, którego już używa Twoje repozytorium. Liczby mnogiej i placeholdery są zachowywane w obu kierunkach. Określ format, dodając parametr format= do dowolnego wywołania.

zdarzenia webhooków

pełny katalog, każdy z przykładowym ładunkiem w dokładnie takim kształcie, w jakim jest dostarczany. GET /v1/webhooks/events.

narzędzia MCP

ten sam token projektu, przekazywany do środowiska wykonawczego agenta zamiast do curl. npx -y @transglot/mcp.

Najczęściej zadawane pytania

Co deweloperzy pytają przed pierwszym zapytaniem.

Jak uwierzytelnić się w API Transglot?

Wyślij token bearer: Authorization: Bearer $TRANSGLOT_TOKEN. Token należy do jednego projektu, więc nie ma identyfikatora projektu w ścieżce ani klucza dla całego konta, który mógłby wyciec. Tworzysz tokeny na stronie projektu, a każdy z nich ma własne uprawnienia: push, pull, manage, read, write.

Czy API jest darmowe?

Nie. Token bearer zaczyna się od planu Starter za 19 USD miesięcznie. Darmowy plan obejmuje konsolę, co wystarcza, aby sprawdzić, czy produkt pasuje, ale nie pozwala na wygenerowanie tokena. CLI, akcja GitHub, webhooki, MCP i pakiet dostaw są dostępne za pomocą tego samego tokena, więc pojawiają się razem.

Jak przesłać ciągi znaków do Transglot?

POST /v1/push z plikiem i jego formatem, na przykład -F "file=@lang/en.json" -F "format=laravel_json". Odpowiada kodem 202 i kolejkuję zadanie wsadowe. Tylko wiersze, które faktycznie uległy zmianie, są tłumaczone, więc przesłanie niezmienionego pliku nic nie kosztuje.

Jak pobrać swoje tłumaczenia?

GET /v1/pull, w dowolnym z 20 formatów, kiedy tylko chcesz. To endpoint, który otacza CLI i który działa na żywo w placu zabaw API. Nie ma potrzeby składania wniosku o eksport ani okna czasowego, w którym dane przestają być Twoje.

Jaki jest limit szybkości API?

60 żądań na minutę, liczone per token, a nie per konto. Po przekroczeniu limitu otrzymujesz kod 429 z nagłówkiem Retry-After informującym, ile sekund czekać, i nic nie jest naliczane ani częściowo zapisywane. Przydziel oddzielne tokeny dla CI i produkcji, aby hałaśliwy build nie zagłodził Twojej aplikacji.

Które języki obsługuje API?

Nie ma stałej listy. Walidator akceptuje każdy tag BCP-47 rozpoznawany przez ICU, czyli 708 locale w tabeli, przeciwko której sprawdza, plus strukturalny fallback dla tagów poza nią. Dodaj locale do projektu, a następne push będzie je zawierać.

Jakie formaty plików mogę przesyłać i pobierać?

Dwadzieścia: JSON płaski i zagnieżdżony, Laravel PHP i JSON, Android XML, iOS .strings, .stringsdict i .xcstrings, Flutter ARB, XLIFF 1.2 i 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV i Unreal PO. Siedem z nich obsługuje formy liczbowe, a plik wraca w takim kształcie, w jakim został wysłany.

Czy Transglot ma webhooki?

Tak. Istnieje 12 zdarzeń webhooków, w tym batch.completed, translation.reviewed, qa.completed i source_drift.repaired. Każda dostawa jest podpisana HMAC z nagłówkiem znacznika czasu, więc możesz ją zweryfikować, a GET /v1/webhooks/events zwraca katalog z przykładową ładunkiem dla każdego z nich.

Czy istnieje serwer MCP dla agentów AI?

Tak. npx -y @transglot/mcp udostępnia 17 narzędzi za pośrednictwem tokena projektu, dzięki czemu asystent może odczytać tłumaczenie, napisać je, dodać język, uruchomić proces, sprawdzić batch lub edytować glosariusz. To ten sam interfejs API i te same uprawnienia, dostępne ze środowiska wykonawczego agenta zamiast z curl.

Czy mogę uruchomić to w CI?

Tak. Akcja GitHub (transglot/transglot-action@v1) oraz CLI opakowują te punkty końcowe. Gdy wiersz zostanie odrzucony, transglot push --wait kończy działanie z kodem 4, a Akcja oznacza zadanie jako nieudane dla tego uruchomienia. Aby zablokować scalanie, uruchom ją na pull requestach z ustawionym inputem commit na none, dodaj krok, który kończy się błędem, gdy w pobranym pliku brakuje klucza, i ustaw zadanie jako wymaganą kontrolę w ochronie gałęzi.

Co się dzieje, gdy tłumaczenie nie przejdzie kontroli jakości?

Cztery deterministyczne bramki sprawdzają każdy wiersz: placeholdery, formy liczby mnogiej, terminy z glosariusza i długość. Nieprawidłowy placeholder, brakująca forma liczby mnogiej lub niedozwolony termin z glosariusza skutkują jedną automatyczną próbą korekty; jeśli nadal występuje błąd, wiersz jest odrzucany, a nie zapisywany. Wiersz, który przekracza jedynie limit długości, jest zapisywany, a nie odrzucany. GET /v1/batches/:id?include=failures wyświetla listę odrzuconych wierszy wraz z przyczynami.

Czy API kiedykolwiek zepsuje moją integrację?

Nie. /v1 tylko zyskuje endpointy i pola odpowiedzi; pole, które już parsujesz, nie zmienia kształtu ani nie znika. Zmiana łamiąca kompatybilność zostałaby wydana pod nowym prefiksem wersji, który jest zarezerwowany i wciąż pusty. Changelog API rejestruje każde wydanie.