API Reference

// translate.mjs — run after build
import { readFileSync, writeFileSync } from "fs";

const API = "https://localify.eeiae.com/api/v1/translate";
const KEY = process.env.LOCALIFY_API_KEY;

async function translate(strings, lang) {
  const res = await fetch(API, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ strings, targetLanguage: lang, tone: "formal" }),
  });
  if (!res.ok) throw new Error(`${lang}: ${(await res.json()).error}`);
  const { translated } = await res.json();
  writeFileSync(`./locales/${lang.toLowerCase()}.json`, JSON.stringify(translated, null, 2));
  console.log(`✓ ${lang}`);
}

const en = JSON.parse(readFileSync("./locales/en.json", "utf8"));
await Promise.all(["Turkish", "German", "French"].map(l => translate(en, l)));

name: Auto-translate
on:
  push:
    paths: ['src/locales/en.json']

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Translate with Localify
        run: |
          node -e "
          const fs = require('fs');
          const KEY = process.env.LOCALIFY_API_KEY;
          const strings = JSON.parse(fs.readFileSync('src/locales/en.json'));
          const langs = ['Turkish', 'German', 'French', 'Spanish'];
          Promise.all(langs.map(async lang => {
            const res = await fetch('https://localify.eeiae.com/api/v1/translate', {
              method: 'POST',
              headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
              body: JSON.stringify({ strings, targetLanguage: lang }),
            });
            const { translated } = await res.json();
            fs.writeFileSync(`src/locales/${lang.toLowerCase()}.json`, JSON.stringify(translated, null, 2));
          }));"
        env:
          LOCALIFY_API_KEY: ${{ secrets.LOCALIFY_API_KEY }}
      - name: Commit translations
        run: |
          git config user.name "Localify Bot"
          git config user.email "bot@localify.eeiae.com"
          git add src/locales/
          git diff --staged --quiet || git commit -m "chore: auto-translate" && git push

import json, requests, os

API = "https://localify.eeiae.com/api/v1/translate"
KEY = os.environ["LOCALIFY_API_KEY"]

def translate(strings: dict, lang: str) -> dict:
    res = requests.post(API, json={
        "strings": strings,
        "targetLanguage": lang,
        "tone": "formal",
        "context": "Django web application",
    }, headers={"Authorization": f"Bearer {KEY}"})
    res.raise_for_status()
    data = res.json()
    print(f"✓ {lang} — {data['meta']['strings']} strings used")
    return data["translated"]

with open("locale/en.json") as f:
    en = json.load(f)

for lang in ["Turkish", "German", "French"]:
    translated = translate(en, lang)
    with open(f"locale/{lang.lower()}.json", "w") as f:
        json.dump(translated, f, ensure_ascii=False, indent=2)