added
Taşıyıcı jetonun projenin kendisi olduğu dağıtım anahtarı modeli. Hem CLI hem de GitHub Action bunun üzerinde çalışır.
api v1 · güncel
API değişiklik günlüğü.
Kaldırılan hiçbir şey yok.
/v1 yalnızca yeni özellikler kazanır. Yeni uç noktalar ve yeni yanıt alanları aynı önek içinde yer alır ve zaten ayrıştırdığınız bir alanın yapısı asla değişmez veya kaybolmaz. Kırıcı bir değişiklik, ayrılmış ve henüz boş olan yeni bir sürüm öneki altında sunulur.
v1/api/v1
kullanımdaki tek önek
kullanımdaki tek önek
5 sürüm
11 değişiklik, hiçbiri kırıcı değil
günlüğün yapısı
Tek sürüm öneki, kaldırma yok.
Bunların dördünden üçü bu günlüğün kendi özellikleridir. Dördüncüsü ise API'nin sunduğu webhook kataloğunun boyutudur.
5
/v1 üzerindeki sürümler, hepsi ekleyici
1
kullanımdaki sürüm öneki. Sonraki önek ayrılmış ve boştur
0
API yayınlandığından beri oluşan kırıcı değişiklikler
12
imzalı webhook olayları. Kaynak: App\Enums\WebhookEvent
semver'a göre değil, sürüme göre tarihli
gezinmek için ok tuşlarını kullanın
2026-07-08
CDN dağıtımı, kullanım ölçümü ve oyun alanı
July 8, 2026 · 4 değişiklik
05 / 05
added
/v1/incontext/translations, /screenshots ve /suggest uç noktaları görsel düzenleyiciyi çalıştırır; CORS yalnızca bu ön ekle sınırlıdır, başka hiçbir şeye izin vermez.
POST /v1/incontext/session, yayımlanabilir bir anahtarı ve Origin bilgisini kapsamlandırılmış bir oturum belirteciyle değiştirir.
improved
İki dilli dışa aktarım artık kaynak metni sessizce yerine koymak yerine gidiş-dönüşü tamamlanamayanları bildirir. Mevcut alanlar değişmeden kalır; başlığa eklenmesinin temel amacı budur.
GET /v1/pull uç noktası X-Skipped-Keys ve X-Missing-Source-Keys yanıt başlıklarını döndürmeye başladı.
added
Ayrıca /v1/glossary/import, /export ve /extract uç noktalarıyla terim tabanı konsolu açmadan içeri ve dışarı aktarılabilir.
API üzerinden tam terim tabanı CRUD desteği: /v1/glossary üzerinde GET, POST, PUT ve DELETE.
added
Bulgular zaten çektiğiniz çeviri satırlarında yer alır, bu nedenle yeni bir yoklama yapmanız gerekmez.
POST /v1/qa/run, ajan tabanlı bir kalite kontrolü tetikler ve çalıştırma tanıtıcısını döndürür.
added
Uç nokta bazında abone olun. Liste App\Enums\WebhookEvent içinde tutulur; bugün on iki durum içerir; bu satırı değil, enum değerlerini sayın.
İmzalı webhook’lar, orijinal toplu çiftin yanı sıra anahtar, çeviri, dil, terim tabanı ve QA olaylarını da yayar.
improved
Teslimat, değişen her satır için ayrı bir çağrı yapmak yerine bir sayaç ve en fazla yirmi örnek taşır. Teslimat günlükleri, sonraki yeniden deneme zamanıyla birlikte her denemeyi kaydeder.
translation.updated gibi yüksek frekanslı olaylar bir zaman penceresinde tek teslimatta birleştirilir, böylece toplu düzenleme bir uç noktayı aşırı yüklemez.
added
Bir ETag ve kısa ömürlü önbellek döndürür; If-None-Match ile 304 yanıtını destekler. /v{n} altındaki sabit kardeş içerik adreslemeli olup bir yıl boyunca önbellekte tutulur.
Herkese açık, kenar önbelleğe alınabilir GET /v1/cdn/{project}/{locale} uç noktası yayımlanmış dizgelerinizi sunar.
added
CI’da POST /v1/cdn/publish ile tetikleyin ve okuma yetkilendirmesi için X-Transglot-Cdn-Key başlığında özel salt-okunur bir anahtar kullanın. Kendi CDN’inizin arkasına koymak güvenlidir.
Yayımlama, mevcut çevirileri manuel olarak veya her push işleminde yeni bir sabit sürüme yükseltir.
added
İstek gövdeleri saklanmaz. Bu yalnızca bir sayımdır, başka bir şey değildir.
Kimlik doğrulamalı her /v1 çağrısı, token başına günlük olarak sayılır ve dağıtım merkezinde gösterilir.
improved
Proje, çekme, toplu işlemler ve terim tabanı dışa aktarma. Çalışması için istek veya yanıt yapısında değişiklik yapılmadı.
Dağıtım merkezi, projenize karşı canlı çalışan salt-okunur uç noktaları sunan bir API oyun alanı kazandı.
kullanımdan kaldırma sicili
Hiçbir şey kaldırılıyor.
Yayınlanan her yüzey için bir satır, yayımlandığı sürümle birlikte. Son sütun dikkat edilmesi gereken sütundur: kaldırma işlemi gerçekleşmeden çok önce burada bir tarihle birlikte görünür.
| Yüzey | Yayınlandı | Durum | Kaldırma tarihi |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | güncel | planlanmış yok |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | güncel | planlanmış yok |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | güncel | planlanmış yok |
POST /v1/qa/run | June 12, 2026 | güncel | planlanmış yok |
Signed webhook events, twelve typed cases | June 30, 2026 | güncel | planlanmış yok |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | güncel | planlanmış yok |
Bu tablodan hiçbir satır silinmez. Bir yüzey emekliye ayrılırsa satırı korunur ve bir tarih eklenir; çünkü planlanabilen bir kaldırma, bunu yayınlamanın asıl amacıdır.
uyumluluk sözü
Üç kural üzerine inşa edebilirsiniz.
eklemeli
Yeni uç noktalar ve yeni yanıt alanları /v1 içinde yayınlanır. Zaten çözümlediğiniz bir alanın yapısı değişmez ve kaybolmaz.
yeni ön ek
Kırıcı bir değişiklik, bu sürümün içinde değil, yeni bir sürüm öneki altında yayımlanır. Bu önek ayrılmıştır ve kullanılmamaktadır; v1 üzerindeki her sürüm bu önekle yayınlanmıştır.
şeffaf başlıklar
Bir çekme (pull) işlemi bir veriyi gidiş-dönüş tamamlayamadığında bunu bir başlıkta belirtir. Gövdeyi değiştirmek yerine X-Skipped-Keys ve X-Missing-Source-Keys eklenmiştir.
SSS
Geliştiricilerin API sürümleme ve kullanım dışı bırakma hakkında sorduğu sorular.
Transglot API sürümleniyor mu?
Evet, URL öneki ile. Şu ana kadar yayımlanan her şey /v1 altında yer alır ve bu tek kullanılan önektir. Bir sürüm başlığı, tarih sabitlemesi veya yapılandırmanız gereken bir şey yoktur.
Bir güncelleme entegrasyonumu bozar mı?
/v1 içinde hayır. Yeni uç noktalar ve yeni yanıt alanları eklenir ancak zaten ayrıştırdığınız bir alanın yapısı değişmez ve kaybolmaz. Eğer bir değişiklik ekleyici olarak yapılamazsa yeni bir önek altında yayımlanır ve eski önek çalışmaya devam eder.
Kullanım dışı bırakılan veya kaldırılan bir şey var mı?
Hiçbir şey ve yukarıdaki kayıt bunu satır satır gösteriyor. Yayımlanan her arayüz, yayımlandığı sürümle birlikte listeleniyor ve kaldırma sütunu aşağıya doğru hep "planlanan yok" olarak okunuyor.
Bir kaldırma işlemi için ne kadar önceden bildirim yapılır?
Bir kaldırma işlemi gerçekleşmeden çok önce o kayıtta bir tarihle görünür ve satır sonrasında kaybolmak yerine tabloda kalır. Planlama yapmanıza olanak tanıyan bir tarih sunmak, bunu yayımlamanın asıl amacıdır.
Yeni bir şey yayımlandığını nasıl anlarım?
Her sürüm bu sayfada tarihli olarak listelenir. Ürün değişiklik günlüğü yayımlanan diğer her şeyi kapsar ve konsol, okumadığınız bir şey olduğunda bir işaret gösterir.
API için neden ayrı bir değişiklik günlüğü var?
Çünkü API, bir ürün sürümünün taşımadığı bir uyumluluk taahhüdü taşır. Bir entegrasyonun hâlâ çalışıp çalışmadığını kontrol eden bir geliştirici, bunu öğrenmek için özellik çalışmaları arasında kaydırma yapmak zorunda kalmamalıdır.
API’yi planıma nasıl eklerim?
Bearer token, Aylık 19 $ karşılığında Starter planda başlar. Ücretsiz paket konsolu kapsar ancak token oluşturmaya izin vermez; CLI, GitHub Action, web kancaları ve MCP ise bu aynı token arkasında yer alır.
Uç noktaların referans belgesi nerede bulunur?
API sayfasında: kimlik doğrulama, uç noktalar, hız sınırı, dosya biçimleri ve web kanca kataloğu. Bu sayfa yalnızca neyin ve ne zaman değiştiğine dair bir kayıttır.
zaten çalıştırdığınız araçlarla uyumlu
41 bağlayıcı, zaten hazır.
sözleşme üründür
Bir API üzerine inşa edin değişmeyen.
API, Starter ve üzeri planlarda mevcuttur. Ücretsiz paket 0 $’dır; başlangıçta 100.000 kelime (kayıt sırasında 25.000, telefon doğrulamasından sonra 75.000), sonrasında aylık 10.000 kelime sunar ve API veya web kancalarını içermez.