Skip to content

Node.js module that allows you to easily interact with the Localazy API.

License

Notifications You must be signed in to change notification settings

localazy/api-client

Repository files navigation

Localazy

localazy-api

@localazy/api-client npm license

📦 Localazy API Client

Node.js module that allows you to easily interact with the Localazy API.

🔧 Install

npm install @localazy/api-client
# or you can use yarn or pnpm

🚀 Usage

ESM
import { ApiClient } from '@localazy/api-client';

const json = { en: { tooltip: 'Elegant unicorn' } }; // Get text to translate.

const api = new ApiClient({ authToken: 'your-project-token' }); // Create Api client.
const project = await api.projects.first(); // Get Localazy project.
const file = await api.import.json({ project, json }); // Import source keys.
const fr = await api.export.json({ project, file, langs: ['fr'] }); // Export translated keys.

console.log(fr); // 🦄 { fr: { tooltip: 'Licorne élégante' } }
TypeScript
import { ApiClient, Project, I18nJson, Locales } from '@localazy/api-client';

const json: I18nJson = { en: { tooltip: 'Elegant unicorn' } };

const api: ApiClient = new ApiClient({ authToken: 'your-project-token' });
const project: Project = await api.projects.first();
const file: File = await api.import.json({ project, json: json });
const fr: I18nJson = await api.export.json({ project, file, langs: [Locales.FRENCH] });

🔐 Project Token

You can obtain the project token at https://localazy.com/developer/tokens.

The project token is permitted to read and write to the single project.

📚 Documentation

ℹ️ Links

🛟 Support

Join the Localazy Discussion Forum to discuss all things localization.

If you encounter any problems or have questions, you can use our forum, GitHub issues or contact us at team@localazy.com.

❤️ Localazy Ecosystem

Check out other npm packages from Localazy:

NPM package Description
cli @localazy/cli Localazy CLI tool.
localazy-api @localazy/api-client Localazy API client.
languages @localazy/languages List of all languages supported by Localazy.
strapi @localazy/strapi-plugin The official Localazy Strapi plugin.

Discover all available integration options and localization examples.

📜 License

Code released under the MIT license.