Entegrasyonlar: better-i18n'i Geliştirme Stack'inize Bağlayın

Entegrasyonlar: better-i18n'i Geliştirme Stack'inize Bağlayın

better-i18n API-first yaklaşımıyla inşa edilmiştir. Her özelliğe programatik olarak erişilebilir; platform, geliştiricilerin günlük olarak kullandığı araçlarla doğrudan entegre olur: kod için GitHub, üretkenlik için yapay zeka asistanları, otomasyon için CI/CD ve runtime için framework SDK'ları.

GitHub

Repository'niz ile better-i18n arasında çift yönlü senkronizasyon:

• Gelen senkronizasyon — Push eventleri, webhook'lar aracılığıyla otomatik çeviri dosyası içe aktarmayı tetikler
• Giden senkronizasyon — Yayımlanan çeviriler, repository'nize pull request olarak gönderilir
• Dosya desenleri — Hangi yolların senkronize edileceğini yapılandırın (örn. locales/**/*.json)
• Minimum izinler — Yalnızca çeviri dosyalarına okuma/yazma, push eventleri için webhook'lar

GitHub entegrasyonu, bulut projeniz ile repository'nizi manuel müdahale olmaksızın senkronize tutar. Çeviri PR'ları üzerinde tam birleştirme kontrolünü siz sürdürürsünüz.

GitHub entegrasyonu hakkında daha fazla bilgi →

Yapay Zeka Asistanları (MCP)

İki MCP sunucusu, yapay zeka araçlarını doğrudan çeviri çalışma alanınıza bağlar:

Desteklenen Yapay Zeka Araçları

Yapay zeka asistanınız key oluşturabilir, içerik çevirebilir, sözlükleri yönetebilir, bekleyen değişiklikleri önizleyebilir ve yayımlayabilir — hepsi doğal dil aracılığıyla.

MCP entegrasyonu hakkında daha fazla bilgi →

CLI

@better-i18n/cli, geliştirme iş akışınıza entegre olur:

Scan: Hardcode Edilmiş Stringleri Tespit Etme

npx @better-i18n/cli scan --ci

React/Next.js kodundaki çevrilmemiş metinleri bulur. useTranslations(), getTranslations(), JSX metni ve öznitelikleri destekler.

Sync: Yerel ile Bulut Karşılaştırması

npx @better-i18n/cli sync --format json

Kodda var olan ancak bulutta olmayan key'leri (eksik) ve bulutta olan ancak kodda kullanılmayan key'leri (kullanılmayan) gösterir.

CI/CD Entegrasyonu

# GitHub Actions
- run: npx @better-i18n/cli scan --ci      # Hardcode edilmiş string içeren PR'ları engelle
- run: npx @better-i18n/cli sync --format json  # Çeviri kapsamını denetle

# Pre-commit hook
npx husky init
echo "npx @better-i18n/cli scan --staged --ci" > .husky/pre-commit

CLI hakkında daha fazla bilgi →

REST API

Tüm çeviri yönetimi işlemlerine tam programatik erişim:

Base URL: https://dash.better-i18n.com/api Auth: Authorization: Bearer your-api-key

API key'leri, dashboard'da oluşturulur, belirli projelere kapsamlandırılır ve anında iptal edilebilir.

REST API hakkında daha fazla bilgi →

Content SDK

Yerelleştirilmiş içerik almak için Supabase tarzı query builder:

import { createClient } from "@better-i18n/sdk";

const client = createClient({
  project: "your-org/your-project",
  apiKey: process.env.BETTER_I18N_CONTENT_API_KEY,
});

const { data, total } = await client
  .from("blog-posts")
  .eq("status", "published")
  .language("fr")
  .order("publishedAt", { ascending: false })
  .limit(20);

Sıfır bağımlılık, TypeScript'te tam olarak tiplendirilmiş, herhangi bir JavaScript runtime'ında çalışır.

Content SDK hakkında daha fazla bilgi →

Framework SDK'ları

Tüm SDK'lar aynı CDN endpoint'ini ve namespace yapısını kullanır. Web ve mobil uygulamalarınız, çeviriler için tek bir kaynak paylaşır.

CDN

Çeviriler, Cloudflare'in edge ağından sunulur:

https://cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json

• Dünya genelinde 100ms altında teslimat (300+ edge konumu)
• Güncellemeler, yayımlanmaktan sonra saniyeler içinde yayılır
• Çeviri değişiklikleri için uygulama yeniden dağıtımı gerekmez
• Dil keşfi için manifest endpoint

CDN teslimatı hakkında daha fazla bilgi →

Özel Entegrasyonlar

REST API ve Content SDK, herhangi bir sistemle özel entegrasyonlar oluşturmanızı sağlar:

• Dahili araçlar — Yönetim panellerinize çeviri yönetimi ekleyin
• Otomatik iş akışları — Event pipeline'ınızdan çevirileri tetikleyin
• Özel dashboard'lar — Çeviri metriklerini analizlerinize çekin
• İçerik pipeline'ları — Yerelleştirilmiş içerikleri CMS'nize entegre edin

Dashboard'da kullanılabilen her işlem, API aracılığıyla da kullanılabilir. HTTP isteği yapabiliyorsanız, better-i18n ile entegre olabilirsiniz.

Başlarken

1. GitHub — Repository'nizi proje ayarlarından bağlayın
2. MCP — Yapay zeka aracınızın yapılandırmasına npx @better-i18n/mcp ekleyin
3. CLI — npm install -D @better-i18n/cli
4. API — dash.better-i18n.com/settings/api-keys adresinden API key oluşturun

Tüm entegrasyonlar, ücretsiz katman dahil her planda kullanılabilir.