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.
https://ravira.dev/api/v1Guida introduttiva
Tre passaggi per la tua prima traduzione:
- 1. Crea un account su ravira.dev/register
- 2. Acquista un pacchetto di caratteri e genera una chiave API in Impostazioni → API
- 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.
Authorization: Bearer rk_live_YOUR_API_KEYEndpoint
/api/v1/translateTraduci il testo. Richiede l'autenticazione. I caratteri vengono addebitati in caso di successo.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| text | stringa | Sì | Testo da tradurre (max 100.000 caratteri) |
| source_lang | stringa | No | Codice della lingua di origine. Predefinito: auto |
| target_lang | stringa | No | Codice della lingua d'arrivo. Predefinito: en |
/api/v1/usageRestituisce 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"
}/api/v1/languagesRestituisce l'elenco delle lingue supportate. Non richiede autenticazione.
curl https://ravira.dev/api/v1/languagesEsempi 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
| HTTP | Codice di errore | Descrizione |
|---|---|---|
| 401 | invalid_api_key | Chiave API mancante, non valida o revocata. |
| 402 | insufficient_balance | Non restano caratteri disponibili sul conto. Acquistane altri su ravira.dev/topup. |
| 429 | rate_limit_exceeded | Troppe richieste. Rallenta e riprova dopo il valore di retry_after (secondi). |
| 400 | errore_di_validazione | Parametri della richiesta non validi. |
| 500 | server_error | Errore 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 429con unaretry_aftercampo (secondi) - Fino a 5 chiavi API per account, per l'organizzazione del progetto
Casi d'uso
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)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);
});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])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 startAnnunci 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);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])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