better-i18n REST API & SDK: プログラムによる翻訳管理

# Translation API（キー管理、翻訳）
curl -H "Authorization: Bearer bi18_live_abc123..." \
  https://dash.better-i18n.com/api/...

# Content API（ヘッドレスCMS）
curl -H "x-api-key: bi-your-api-key" \
  https://content.better-i18n.com/v1/content/acme/web-app/models

listProjects()          → アクセス可能なすべてのプロジェクトを一覧表示
getProject(project)     → プロジェクトの詳細、言語、ネームスペースを取得

listKeys(project, options)    → 翻訳キーを検索・閲覧
createKeys(project, keys)     → ソーステキストと翻訳付きでキーを作成
updateKeys(project, updates)  → 既存キーの翻訳を更新
deleteKeys(project, keys)     → 翻訳キーをソフトデリート

{
  "project": "acme/web-app",
  "keys": [
    {
      "name": "auth.login.title",
      "namespace": "auth",
      "sourceText": "Sign in to your account",
      "translations": {
        "tr": "Hesabınıza giriş yapın",
        "de": "Melden Sie sich bei Ihrem Konto an"
      }
    },
    {
      "name": "auth.login.button",
      "namespace": "auth",
      "sourceText": "Sign in"
    }
  ]
}

{
  "project": "acme/web-app",
  "search": "login",
  "namespaces": ["auth"],
  "missingLanguage": "tr"
}

{
  "project": "acme/web-app",
  "translations": [
    {
      "key": "auth.login.title",
      "language": "tr",
      "text": "Hesabınıza giriş yapın",
      "status": "approved"
    }
  ]
}

addLanguage(project, language)   → 新しいターゲット言語を追加
getProject(project)              → すべてのアクティブな言語と進捗を確認

getSyncs(project)    → 最近のSync操作（GitHub、CDNなど）を一覧表示
getSync(project, id) → 特定のSyncジョブの詳細を取得

npm install @better-i18n/sdk

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

const client = createClient({
  project: "acme/web-app",
  apiKey: process.env.BETTER_I18N_API_KEY!,
});

// 公開済みブログ記事を一覧表示
const { data: posts, total, hasMore } = await client
  .from("blog-posts")
  .eq("status", "published")
  .order("publishedAt", { ascending: false })
  .expand("author", "category")
  .limit(10);

// フランス語で単一エントリを取得
const { data: post } = await client
  .from("blog-posts")
  .language("fr")
  .single("getting-started");

console.log(post.title, post.body);

# コードベース内のハードコードされた文字列を検出
better-i18n scan

# ローカルキーとクラウドプロジェクトを比較
better-i18n sync

# JSON出力でCI/CD連携
better-i18n scan --ci --format json
better-i18n sync --format json

# プリコミットフック
npx @better-i18n/cli scan --staged --ci

# GitHub Actions
- run: npx @better-i18n/cli scan --ci --format json

# MCPサーバーをインストール
npm install @better-i18n/mcp

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

https://cdn.better-i18n.com/acme/web-app/de/common.json