Transept'i API ile Otomatikleştirin

Ayarlar → Geliştirici altından kişisel bir API anahtarı oluşturun. Ücretsiz dahil her planda mevcuttur; ayrı bir kısıtlama yoktur, kullanımı kelime bakiyeniz belirler. Anahtara bir isim verin, isterseniz bir son kullanma tarihi belirleyin ve gösterildiğinde gizli anahtarı kopyalayın: Bu anahtar yalnızca bir kez gösterilir ve daha sonra tekrar erişilemez. İstediğiniz zaman aynı sayfadan bir anahtarı iptal edebilirsiniz.

İstekler, Authorization: Bearer tsk_live_… başlığındaki anahtarla doğrulanır — yalnızca başlıkta, asla URL'de değil.

Ham metin, HTML veya markdown kullanarak bir belge oluşturun ya da bir dosya yükleyin — uygulamanın kabul ettiği formatların aynısı. Ayrıca bir string tablosu (.tstrings.json) da içe aktarabilirsiniz: Bu, her dizenin sabit bir anahtara ve ne olduğu, nerede göründüğü, karakter sınırı ve yer tutucuların anlamı hakkında bir not içeren kendi bağlamına sahip bir birim olduğu, kullanıcı arayüzü metni veya oyun dizeleri için yapılandırılmış bir formattır. Tüm bu bilgiler modele iletilir; {name} gibi yer tutucular silinmeye veya yeniden adlandırılmaya karşı korunur ve çoğul yapılar dile göre genişletilir (İngilizcedeki tek bir form Almancada ikiye, Ukraynacada dörde çıkar). Dosyanın halihazırda içerdiği tüm çeviriler olduğu gibi ve ücretsiz olarak içe aktarılır ve çeviri belleğini anında besler.

Toplu çalıştırma, aynı anda birden fazla dile çeviri yapılmasını sağlar. Belgeyi, çalıştırılacak Workflow'u veya şablonu ve hedef dilleri belirtin; Transept eksik dil sürümlerini oluşturur ve her biri için Workflow'u çalıştırır. Tüm süreci tek bir ID takip eder; her dilin ilerleme durumunu ve inceleme bekleyip beklemediğini bu ID üzerinden sorgulayabilirsiniz.

Tekrarlanan çalıştırmalar için bir string tablosunun güncel dosyasını yeniden gönderin; Transept nelerin değiştiğini kendisi belirler: Değişmeyen dizeler çevirilerini (ve halihazırda yapılmış incelemeleri) korur ve çalıştırma yalnızca yeni veya gerçekten değişmiş birimlere uygulanır — bu, Yalnızca değişenleri çalıştır özelliğinin API tarafıdır. İş oluşturan bir çağrı, aynı zamanda bir Idempotency-Key başlığını da kabul eder; böylece ağdaki anlık bir aksaklık sonrası yapılan tekrar denemesi, ikinci bir belge ve ikinci bir fatura yerine orijinal sonucu döndürür.

Sürekli sorgulama (polling) yerine bir URL kaydedin; Transept bir çalıştırma tamamlandığında veya başarısız olduğunda, bir inceleme incelenmeye hazır olduğunda, bir yükleme işlemi bittiğinde veya bir dışa aktarma hazır olduğunda bir push etkinliği gönderir. Her iletim, alıcınızın iletinin gerçekten bizden geldiğini doğrulayabilmesi için bir HMAC-SHA256 X-Transept-Signature: t=…,v1=… başlığı taşır; hata veren bir uç nokta ise devre dışı bırakılmadan önce artan aralıklarla (backoff) tekrar denenir.

Bir Workflow, bir Notion veritabanı otomasyonu üzerinden de otomatik olarak çalışabilir: Otomasyonun webhook'unu tetikleyici URL'sine yönlendirdiğinizde Transept, Workflow'u değişen sayfa üzerinde çalıştırır. Buradaki püf noktası, Notion webhook'unun sayfa içeriğini asla taşımamasıdır; yalnızca hangi sayfanın tetiklendiğini bildirir. Transept bu sayfayı sizin Notion bağlantınız üzerinden okuduğu için şu iki şartın da sağlanması gerekir; aksi takdirde her tetikleme bir erişim hatasıyla geri çevrilir ve tetikleyici kartında “Notion sayfası okunamadı” notu görünür:

• Notion'ı Transept'e bağlayın — Ayarlar → Entegrasyonlar altından. Bu, Transept'in sizin adınıza okuma yapmasına olanak tanıyan tek seferlik OAuth bağlantısıdır.
• Kaynak veritabanını Notion içindeki entegrasyonla paylaşın — veritabanını (veya sayfayı) açın, ••• menüsüne tıklayın, Bağlantılar'ı seçin ve Transept'i ekleyin. Ayarlar'da Notion'ı bağlamak, tek başına belirli bir veritabanına erişim izni vermez; bu adım olmadan bağlantı aktif olsa bile sayfa okunamaz kalır.
• Sadece içerik düzenlemesinde değil, özellik değişikliğinde tetikleyin. Notion otomasyonları özellik değişikliklerinde (ve sayfa eklemelerinde) tetiklenir, bu yüzden sadece bir sayfanın içeriğini düzenlemek hiçbir şeyi tetiklemeyebilir. En güvenilir yöntem, otomasyonun izlediği bir Durum özelliğidir; bunu değiştirdiğinizde (örneğin “Çeviriye hazır” yaparak) tetikleyiciyi çağıran şey bu değişikliktir.

Uç noktaların tam listesi, n8n, Zapier veya bir kod oluşturucuya aktarabileceğiniz bir OpenAPI spesifikasyonu olarak yayınlanır: Bu listeye Transept API'nizdeki /public/v1/docs adresinden göz atabilir veya /public/v1/openapi.json adresinden ham JSON dosyasını çekebilirsiniz. API üzerinden başlatılan çalıştırmalar, tıpkı uygulama içi editörde olduğu gibi kelime sayısı üzerinden ücretlendirilir.