Page cover

Quickstart

Super fast intro to all Tranzo features

To start working with the Tranzo API, you should create an API key on the dashboard:

  • Open the dashboard

  • Click on the button "Create new API key"

  • Give your key a useful name, for example, "Private key for my project X"

  • Smash the create button

  • You'll see your API key appear on the dashboard

  • Click on the button "Copy the key header" in your new key row

Now you have the key's HTTP header copied to your clipboard. You can paste it instead of the {paste the key header here} placeholder and run the console command to see the first result:

curl -X 'POST' \
  'https://api.tranzo.io/api/v1/translate' \
  -H 'accept: application/json' \
  -H 'Authorization: {paste the key header here}' \
  -H 'Content-Type: application/json' \
  -d '{
  "text": "Привет, мир!",
  "target": "en",
  "source": "ru"
}'

You should get the response:

Congratulations! You've finished your first request to the Tranzo API. Now let me explain each request parameter:

  • text - It's your text for translation

  • target - the 2-letter code for the language you want to translate to ("en", "fr", etc.)

  • source - the 2-symbol language code of the original text ("en", "fr", etc.). It's an optional parameter. Without it, Tranzo will try to detect the source language by itself.

You can get all available languages for "target" and "source" params by requesting the API language endpoint

That's all! Now you can use the full power of Tranzo, but pay attention to the limitations!

Last updated