Documentazione API

L'API RAVIRA offre accesso programmatico a traduzioni di livello professionale con terminologia coerente. Effettua l'autenticazione con un token Bearer e inizia a tradurre in pochi minuti.

URL di basehttps://ravira.dev/api/v1

Guida introduttiva

Tre passaggi per la tua prima traduzione:

  1. 1. Crea un account su ravira.dev/register
  2. 2. Acquista un pacchetto di caratteri e genera una chiave API in Impostazioni → API
  3. 3. Invia la tua prima richiesta:
curl -X POST https://ravira.dev/api/v1/translate \
  -H "Authorization: Bearer rk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello, world!", "source_lang": "en", "target_lang": "ro"}'

Risposta:

{
  "translated_text": "Bună ziua, lume!",
  "characters_charged": 13,
  "source_lang": "en",
  "target_lang": "ro"
}

Autenticazione

Tutte le richieste API richiedono un token Bearer nell' Authorization intestazione. Le chiavi API iniziano con rk_live_ e vengono generate nelle impostazioni del tuo account.

Importante: La tua chiave API viene mostrata solo una volta, al momento della creazione. Conservala in un luogo sicuro: non può essere recuperata.
Authorization: Bearer rk_live_YOUR_API_KEY

Endpoint

POST/api/v1/translate

Traduci il testo. Richiede l'autenticazione. I caratteri vengono addebitati in caso di successo.

ParametroTipoObbligatorioDescrizione
textstringaSìTesto da tradurre (max 100.000 caratteri)
source_langstringaNoCodice della lingua di origine. Predefinito: auto
target_langstringaNoCodice della lingua d'arrivo. Predefinito: en
GET/api/v1/usage

Restituisce il saldo attuale di caratteri e il loro utilizzo. Richiede l'autenticazione.

curl https://ravira.dev/api/v1/usage \
  -H "Authorization: Bearer rk_live_YOUR_API_KEY"
{
  "characters_balance": 500000,
  "characters_used": 12500,
  "characters_expires_at": "2027-01-01T00:00:00"
}
GET/api/v1/languages

Restituisce l'elenco delle lingue supportate. Non richiede autenticazione.

curl https://ravira.dev/api/v1/languages

Esempi di codice

Python

import requests

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def translate(text, target_lang="ro", source_lang="auto"):
    response = requests.post(
        f"{BASE_URL}/translate",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"text": text, "source_lang": source_lang, "target_lang": target_lang}
    )
    response.raise_for_status()
    return response.json()["translated_text"]

result = translate("Hello, world!", target_lang="ro")
print(result)  # Bună ziua, lume!

JavaScript

const API_KEY = "rk_live_YOUR_API_KEY";
const BASE_URL = "https://ravira.dev/api/v1";

async function translate(text, targetLang = "ro", sourceLang = "auto") {
  const response = await fetch(`${BASE_URL}/translate`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ text, source_lang: sourceLang, target_lang: targetLang }),
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const data = await response.json();
  return data.translated_text;
}

const result = await translate("Hello, world!", "ro");
console.log(result); // Bună ziua, lume!

Codici di errore

HTTPCodice di erroreDescrizione
401invalid_api_keyChiave API mancante, non valida o revocata.
402insufficient_balanceNon restano caratteri disponibili sul conto. Acquistane altri su ravira.dev/topup.
429rate_limit_exceededTroppe richieste. Rallenta e riprova dopo il valore di retry_after (secondi).
400errore_di_validazioneParametri della richiesta non validi.
500server_errorErrore interno del server. Riprova dopo qualche istante.

Limiti di utilizzo

Si applicano limiti di utilizzo per account, non per chiave API.

  • 60 richieste/minuto per account, per tutte le chiavi API
  • Se si supera il limite, l'API restituisce HTTP 429 con una retry_after campo (secondi)
  • Fino a 5 chiavi API per account, per l'organizzazione del progetto

Casi d'uso

E-commerce

Inclusioni nel listino multilingue

Un venditore su Amazon o eBay vuole pubblicare automaticamente i prodotti in 5 lingue. Una chiamata API per lingua: terminologia coerente in tutti i mercati.

import requests

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def translate_product(product):
    languages = {"ro": "Romanian", "de": "German", "fr": "French", "es": "Spanish"}
    translations = {}
    for lang_code, lang_name in languages.items():
        response = requests.post(
            BASE_URL + "/translate",
            headers={"Authorization": "Bearer " + API_KEY},
            json={"text": product["title"] + "

" + product["description"],
                  "source_lang": "en", "target_lang": lang_code}
        )
        translations[lang_code] = response.json()["translated_text"]
    return translations

product = {
    "title": "Wireless Noise-Cancelling Headphones",
    "description": "Premium over-ear headphones with 30-hour battery."
}
result = translate_product(product)
SaaS

Notifiche utente localizzate

Una piattaforma SaaS traduce tutti i modelli di notifica quando un nuovo utente imposta la lingua preferita. Nessun file di traduzione statico: contenuti dinamici e sempre aggiornati.

const API_KEY = "rk_live_YOUR_API_KEY";
const BASE_URL = "https://ravira.dev/api/v1";

async function localizeNotifications(userId, targetLang) {
  const templates = {
    welcome: "Welcome to our platform! Your account is ready.",
    trial_ending: "Your free trial ends in 3 days.",
    payment_success: "Payment confirmed. Thank you!",
    usage_alert: "You have used 80% of your monthly quota."
  };
  const localized = {};
  for (const [key, text] of Object.entries(templates)) {
    const res = await fetch(BASE_URL + "/translate", {
      method: "POST",
      headers: {
        "Authorization": "Bearer " + API_KEY,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({ text, source_lang: "en", target_lang: targetLang })
    });
    localized[key] = (await res.json()).translated_text;
  }
  return localized;
}

// New user from Romania
localizeNotifications("user_123", "ro").then(t => {
  console.log(t.welcome);
});
Legale

Pretraduzione di contratti

Uno studio legale riceve contratti in lingue straniere e ha bisogno di una pretraduzione rapida prima di inviarli a un traduttore certificato. Una terminologia giuridica coerente riduce i tempi di revisione.

import requests

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def pretranslate_contract(contract_text, source_lang):
    """Pre-translate a contract for internal review."""
    response = requests.post(
        BASE_URL + "/translate",
        headers={"Authorization": "Bearer " + API_KEY},
        json={
            "text": contract_text,
            "source_lang": source_lang,
            "target_lang": "en"
        }
    )
    return response.json()["translated_text"]

# Translate a German contract for English-speaking lawyers
with open("vertrag_2026.txt", "r") as f:
    german_contract = f.read()

english_draft = pretranslate_contract(german_contract, "de")
print("Pre-translation ready for legal review.")
print(english_draft[:200])
Giornalismo

Monitoraggio delle notizie internazionali

Una redazione monitora fonti internazionali e traduce automaticamente gli articoli pertinenti per i redattori. L'operazione viene eseguita ogni ora come processo pianificato.

import requests
import schedule
import time

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def translate_article(article, source_lang):
    response = requests.post(
        BASE_URL + "/translate",
        headers={"Authorization": "Bearer " + API_KEY},
        json={"text": article, "source_lang": source_lang, "target_lang": "en"}
    )
    return response.json()["translated_text"]

def monitor_and_translate():
    # Fetch articles from your news source here
    articles = [
        {"text": "Neue Wirtschaftsdaten zeigen starkes Wachstum...", "lang": "de"},
        {"text": "Les negociations commerciales reprennent...", "lang": "fr"},
    ]
    for article in articles:
        translated = translate_article(article["text"], article["lang"])
        print("Translated:", translated[:80] + "...")

# Run every hour
schedule.every().hour.do(monitor_and_translate)
monitor_and_translate()  # Run immediately on start
Risorse umane

Annunci di lavoro multilingue

Un'azienda che pubblica offerte di lavoro in tutta Europa traduce automaticamente ogni annuncio. Un'unica versione sorgente in inglese, pubblicata in 6 lingue nel giro di pochi secondi.

const API_KEY = "rk_live_YOUR_API_KEY";
const BASE_URL = "https://ravira.dev/api/v1";

const TARGET_MARKETS = ["de", "fr", "es", "it", "pl", "ro"];

async function publishJobPosting(jobDescription) {
  const postings = {};
  for (const lang of TARGET_MARKETS) {
    const res = await fetch(BASE_URL + "/translate", {
      method: "POST",
      headers: {
        "Authorization": "Bearer " + API_KEY,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        text: jobDescription,
        source_lang: "en",
        target_lang: lang
      })
    });
    postings[lang] = (await res.json()).translated_text;
  }
  console.log("Published in " + Object.keys(postings).length + " languages");
  return postings;
}

const job = "Senior Backend Engineer. Remote. Competitive salary.";
publishJobPosting(job);
Tecnico

Documentazione del software

Uno strumento per sviluppatori traduce la propria documentazione per raggiungere utenti internazionali. I file Markdown vengono tradotti, mentre i blocchi di codice restano intatti.

import requests
import re

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def translate_markdown(md_text, target_lang):
    """Translate markdown, preserving code blocks."""
    # Extract code blocks before translation
    code_blocks = {}
    def save_code(match):
        key = f"CODE_BLOCK_{len(code_blocks)}"
        code_blocks[key] = match.group(0)
        return key
    protected = re.sub(r"```[\s\S]*?```", save_code, md_text)
    # Translate text only
    response = requests.post(
        BASE_URL + "/translate",
        headers={"Authorization": "Bearer " + API_KEY},
        json={"text": protected, "source_lang": "en", "target_lang": target_lang}
    )
    translated = response.json()["translated_text"]
    # Restore code blocks
    for key, block in code_blocks.items():
        translated = translated.replace(key, block)
    return translated

with open("README.md") as f:
    readme = f.read()
translated_readme = translate_markdown(readme, "ro")
print(translated_readme[:300])
Medico

Moduli di accettazione dei pazienti

Una clinica traduce i moduli di accettazione dei pazienti per i pazienti internazionali. Per uso interno e per il comfort dei pazienti: i contenuti vengono sempre verificati da personale medico qualificato prima di prendere decisioni cliniche.

import requests

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def translate_intake_form(form_data, patient_lang):
    """
    Translate patient intake form for non-English speaking patients.
    For internal use only. Always reviewed by qualified medical staff.
    """
    fields_to_translate = [
        "chief_complaint", "medical_history", "current_medications", "allergies"
    ]
    translated = {}
    for field in fields_to_translate:
        if field in form_data:
            response = requests.post(
                BASE_URL + "/translate",
                headers={"Authorization": "Bearer " + API_KEY},
                json={
                    "text": form_data[field],
                    "source_lang": patient_lang,
                    "target_lang": "en"
                }
            )
            translated[field] = response.json()["translated_text"]
    return translated

patient_form = {
    "chief_complaint": "Durere puternica in piept de 2 zile",
    "allergies": "Penicilina, Ibuprofen"
}
english_form = translate_intake_form(patient_form, "ro")
print("For medical staff review:", english_form)

Pronto per iniziare?

Genera la tua chiave API in pochi secondi. Nessun costo di attivazione né abbonamento: paghi solo per i caratteri che traduci.

Domande? Scrivici a humans@ravira.dev