better-i18n REST API & SDK: 프로그래밍 방식의 번역 관리

# Translation API (키 관리, 번역)
curl -H "Authorization: Bearer bi18_live_abc123..." \
  https://dash.better-i18n.com/api/...

# Content API (headless 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

# Pre-commit 훅
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