added
Model klucza wdrożeniowego, w którym token bearer JEST projektem. To na nim działają zarówno CLI, jak i akcja GitHub.
api v1 · aktualne
Dziennik zmian API.
Nic nie zostało usunięte.
/v1 tylko zyskuje nowe elementy. Nowe endpointy i pola odpowiedzi trafiają do tego samego prefiksu, a pole, które już parsujesz, nigdy nie zmienia kształtu ani nie znika. Zmiana łamiąca kompatybilność zostałaby wypuszczona pod nowym prefiksem wersji, który jest zarezerwowany i obecnie pusty.
v1/api/v1
jedyny używany prefiks
jedyny używany prefiks
5 wydań
11 zmian, żadna z nich nie łamie kompatybilności
kształt dziennika
Jeden prefiks wersji, bez usuwania.
Trzy z tych czterech elementów są właściwościami samego tego dziennika. Czwartym jest rozmiar katalogu webhooków obsługiwanych przez API.
5
wydania na /v1, każde z nich addytywne
1
używany prefiks wersji. Następny jest zarezerwowany i pusty
0
zmiany łamiące kompatybilność od momentu uruchomienia API
12
podpisane zdarzenia webhook. Źródło: App\Enums\WebhookEvent
datowane według wydania, nie według semver
użyj klawiszy strzałek, aby poruszać się
2026-07-08
Dostawa przez CDN, pomiary użycia i plac zabaw API
July 8, 2026 · 4 zmian
05 / 05
added
/v1/incontext/translations, /screenshots oraz /suggest obsługują edytor wizualny, z CORS ograniczonym do tego prefiksu i niczego więcej.
POST /v1/incontext/session wymienia klucz publikowalny i Origin na token sesji o ograniczonym zakresie.
improved
Eksport dwujęzyczny raportuje teraz elementy, których nie udało się przetworzyć w obie strony, zamiast cicho podstawiać tekst źródłowy. Istniejące pola pozostają bez zmian – to właśnie jest celem umieszczenia tych informacji w nagłówku.
GET /v1/pull otrzymał nagłówki odpowiedzi X-Skipped-Keys i X-Missing-Source-Keys.
added
Dodatkowo /v1/glossary/import, /export i /extract, dzięki czemu bazę terminów można przenosić bez otwierania konsoli.
Pełne operacje CRUD dla bazy terminów przez API: GET, POST, PUT i DELETE na /v1/glossary.
added
Wyniki trafiają do wierszy tłumaczeń, które już pobierasz, więc nie trzeba odpytywać o nic nowego.
POST /v1/qa/run uruchamia agentową kontrolę jakości i zwraca uchwyt przebiegu.
added
Subskrypcja per endpoint. Lista znajduje się w App\Enums\WebhookEvent, który obecnie zawiera dwanaście przypadków; liczbę należy odczytywać z enuma, a nie z tego opisu.
Podpisane webhooki emitują zdarzenia związane z kluczami, tłumaczeniami, językami, słownikiem i QA alongside oryginalnej pary wsadowej.
improved
Dostawa zawiera licznik i do dwudziestu próbek, zamiast jednego wywołania na każdy zmieniony wiersz. Logi dostaw rejestrują każdą próbę wraz z czasem następnej ponownej próby.
Zdarzenia o wysokiej częstotliwości, takie jak translation.updated, są łączone w jedną dostawę w oknie czasowym, dzięki czemu masowa edycja nie zalewa endpointu.
added
Zwraca ETag i krótkotrwały cache oraz honoruje If-None-Match kodem 304. Niezmienny odpowiednik pod /v{n} jest adresowany treścią i cache’owany przez rok.
Publiczny, cache’owalny na krawędzi sieci GET /v1/cdn/{project}/{locale} udostępnia Twoje opublikowane ciągi znaków.
added
Uruchom to w CI za pomocą POST /v1/cdn/publish i autoryzuj odczyt dedykowanym kluczem tylko do odczytu w nagłówku X-Transglot-Cdn-Key. Bezpieczne do umieszczenia za własnym CDN.
Publikacja promuje bieżące tłumaczenia do nowej, niezmiennej wersji, ręcznie lub przy każdym pushu.
added
Treści żądań nie są przechowywane. Liczona jest tylko liczba wywołań.
Każde uwierzytelnione wywołanie /v1 jest liczone per token dziennie i wyświetlane w hubie wdrożeń.
improved
Projekt, pull, batche i eksport słownika. Żaden kształt żądania ani odpowiedzi nie uległ zmianie, aby to umożliwić.
Hub wdrożeń zyskał plac zabaw API, który na żywo uruchamia endpointy tylko do odczytu w Twoim projekcie.
rejestr wycofanych funkcji
Nic nie jest znika.
Jeden wiersz dla każdego opublikowanego interfejsu, wraz z wersją, w której został wprowadzony. Ostatnia kolumna jest najważniejsza: usunięcie pojawiłoby się tam z datą na długo przed jego faktycznym wystąpieniem.
| Interfejs | Wydano | Status | Data usunięcia |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | bieżący | brak zaplanowanych |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | bieżący | brak zaplanowanych |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | bieżący | brak zaplanowanych |
POST /v1/qa/run | June 12, 2026 | bieżący | brak zaplanowanych |
Signed webhook events, twelve typed cases | June 30, 2026 | bieżący | brak zaplanowanych |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | bieżący | brak zaplanowanych |
Wiersz nigdy nie jest usuwany z tej tabeli. Jeśli interfejs zostaje wycofany, zachowuje swój wiersz i otrzymuje datę, ponieważ możliwość zaplanowania usunięcia to główny cel jego publikacji.
obietnica zgodności
Trzy zasady na których możesz budować.
addycyjny
Nowe punkty końcowe i nowe pola odpowiedzi są udostępniane w ramach /v1. Pole, które już parsujesz, nie zmienia kształtu ani nie znika.
nowy prefiks
Zmiana niekompatybilna wstecz zostałaby wprowadzona pod nowym prefiksem wersji, a nie w ramach obecnej. Ten prefiks jest zarezerwowany i nieużywany, a wszystkie dotychczasowe wydania trafiły do v1.
rzetelne nagłówki
Gdy pull request nie może obsłużyć zwrotnego przesyłania danych, informuje o tym w nagłówku. Dodano nagłówki X-Skipped-Keys i X-Missing-Source-Keys, zamiast zmieniać treść odpowiedzi bez ostrzeżenia.
Najczęściej zadawane pytania
Pytania, które programiści zadają na temat wersjonowania API i wycofywania funkcji.
Czy API Transglot jest wersjonowane?
Tak, poprzez prefiks URL. Wszystko opublikowane do tej pory znajduje się pod /v1, który jest jedynym używanym prefiksem. Nie ma nagłówka wersji, przypinania dat ani niczego do konfigurowania.
Czy aktualizacja kiedykolwiek zepsuje moją integrację?
Nie w ramach /v1. Dodawane są nowe punkty końcowe i nowe pola odpowiedzi, ale pole, które już parsujesz, nie zmienia kształtu ani nie znika. Jeśli zmiana nie może zostać wykonana addytywnie, trafi ona pod nowy prefiks, a stary będzie nadal działać.
Czy coś zostało wycofane lub usunięte?
Nic, a powyższy rejestr potwierdza to wiersz po wierszu. Każda opublikowana powierzchnia jest wymieniona wraz z wydaniem, w którym została udostępniona, oraz kolumną usuwania, która obecnie wszędzie wskazuje „brak zaplanowanych”.
Jakie wyprzedzenie otrzymałoby usunięcie?
Usunięcie pojawiłoby się w tym rejestrze z datą na długo przed jego faktycznym nastąpieniem, a wiersz pozostałby w tabeli również afterwards, zamiast znikać. Możliwość planowania z wyprzedzeniem jest głównym celem publikowania takich informacji.
Jak dowiem się, gdy pojawi się coś nowego?
Każde wydanie jest datowane na tej stronie. Dziennik zmian produktu obejmuje wszystko inne, co zostaje wydane, a konsola pokazuje znacznik, gdy jest coś, czego jeszcze nie przeczytałeś.
Dlaczego istnieje osobny dziennik zmian dla API?
Ponieważ API objęte jest obietnicą zgodności, której nie gwarantuje wydanie produktu. Deweloper sprawdzający, czy integracja nadal działa, nie powinien muszyć przewijać się przez informacje o nowych funkcjach, aby to ustalić.
Jak dodać API do mojego planu?
Token bearer rozpoczyna się od planu Starter za 19 USD miesięcznie. Plan Free obejmuje konsolę, ale nie umożliwia generowania tokenów, a CLI, GitHub Action, webhooki i MCP wymagają tego samego tokenu.
Gdzie znajduje się dokumentacja referencyjna samych endpointów?
Na stronie API: uwierzytelnianie, endpointy, limity żądań, formaty plików oraz katalog webhooków. Ta strona zawiera wyłącznie rejestr zmian i dat ich wprowadzenia.
działa z narzędziami, których już używasz
41 gotowych konektorów.
kontrakt jest produktem
Buduj na API który się nie zmienia.
API dostępne jest w planie Starter i wyższych. Plan Free kosztuje 0 USD i oferuje 100 000 słów na start (25 000 przy rejestracji, 75 000 po weryfikacji telefonicznej), a następnie 10 000 miesięcznie, bez dostępu do API i webhooków.