API dokumentācija

Ievads

Tulkošanas API tulko tekstu, HTML un strukturētu JSON līdz 24 ES oficiālajās valodās. Pieprasījumi un atbildes ir JSON (UTF-8) formātā. Katrs pieprasījums izvēlas kvalitātes līmeni: basic (AI), pro (AI ar terminoloģijas ievērošanu) vai review (papildus dzimtās valodas izlases pārbaude, asinhroni).

Lai izmēģinātu, izmantojiet publisko smilškastes atslēgu no klienta zonas – tā uzvedas kā ražošanas atslēga, bet ir ierobežota testa kvotai. Ražošanas atslēgu saņemsiet pēc īsas aktivizācijas, izmantojot savu klienta kontu.

Publiskais sandbox atslēgabd_test_sandbox_2026

Autentifikācija

Katrs pieprasījums ietver jūsu API atslēgu Authorization galvenē kā Bearer tokenu. Atslēgas sākas ar bd_test_ (smilškaste) vai bd_live_ (ražošana). Atslēgas apstrādājiet kā paroles: nekad frontend kodā, nekad repozitorijā – ja ir aizdomas par kompromitāciju, atsauciet un izveidojiet jaunu klienta zonā.

Pieprasījumus bez derīgas atslēgas API atbild ar statusu 401. Atslēgai jebkurā laikā var iestatīt mēneša ierobežojumu vārdos; sasniedzot to, API atbild ar statusu 402, līdz jūs paaugstināt ierobežojumu.

Authorization: Bearer bd_live_ihr_schluessel

Teksta tulkošana

POST/api/v1/translate

Centrālais galapunkts tulko vienu vai vairākus tekstus mērķvalodā. Lauks format kontrolē apstrādi: text (noklusējums), html (iezīmes saglabājas) vai json (tikai virknes vērtības tiek tulkotas, atslēgas un struktūra paliek nemainīgas).

Atbildē ir tulkojumi ievades secībā, saskaitītie avota vārdi un aprēķinātās izmaksas centos. Izmantojot izvēles galveni Idempotency-Key, novēršat dubultu apstrādi tīkla atkārtojumos: identiskas atslēgas sniedz saglabāto pirmo atbildi.

curl https://www.baduno.com/api/v1/translate \
  -H "Authorization: Bearer bd_test_sandbox_2026" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "fr",
    "texts": ["Kostenloser Versand ab 50 Euro."],
    "format": "text",
    "tier": "basic"
  }'

{
  "ok": true,
  "target": "fr",
  "tier": "basic",
  "translations": ["Livraison gratuite à partir de 50 euros."],
  "words": 6,
  "cost_cents": 12,
  "detected_source": "de"
}

Parametrs

const res = await fetch("https://www.baduno.com/api/v1/translate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.BADUNO_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ target: "it", texts: [title, description], format: "html" })
});
const { translations } = await res.json();

import os, requests

r = requests.post(
    "https://www.baduno.com/api/v1/translate",
    headers={"Authorization": f"Bearer {os.environ['BADUNO_API_KEY']}"},
    json={"target": "pl", "texts": ["Zurück zur Startseite"], "tier": "pro"},
    timeout=30,
)
r.raise_for_status()
print(r.json()["translations"][0])

$ch = curl_init("https://www.baduno.com/api/v1/translate");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("BADUNO_API_KEY"),
    "Content-Type: application/json"
  ],
  CURLOPT_POSTFIELDS => json_encode(["target" => "es", "texts" => [$text]])
]);
$out = json_decode(curl_exec($ch), true);

Batch & Webhooki

POST/api/v1/batches

Lieliem apjomiem vai pārskatīšanas posmam strādājiet asinhroni: Batch galapunkts pieņem līdz 1000 tekstiem un nekavējoties atbild ar darba ID. Kad darbs ir pabeigts – pārskatīšanā pēc dzimtās valodas izlases – API izsauc jūsu norādīto Webhook URL ar rezultātu.

Webhook izsaukumi ir parakstīti ar HMAC-SHA-256 galveni, kuru varat pārbaudīt ar savu Webhook noslēpumu. Ja jūsu serveris neatbild ar statusu 2xx, piegāde tiek atkārtota līdz piecām reizēm ar pieaugošu intervālu; darbi papildus paliek pieejami 30 dienas, izmantojot GET.

POST /api/v1/batches            → { "ok": true, "job": "job_8f2…", "status": "processing" }
GET  /api/v1/batches/job_8f2…   → { "ok": true, "status": "done", "results": [ … ] }

Glosāriji

POST/api/v1/glossaries

Glosāriji nodrošina jūsu terminoloģiju: katram ierakstam ir avota termins un tā obligātais tulkojums katrā mērķvalodā. Tiek augšupielādēts kā CSV klientu portālā vai ar API; līmenis pro un review padara trāpījumus obligātus, basic tos izmanto kā ieteikumu.

Katrā kontā ir iespējami līdz 20 glosārijiem ar 5 000 ierakstiem katrā. Izmaiņas nekavējoties ietekmē visus turpmākos pieprasījumus – tāpēc glosārijus versionējiet kā kodu un izmaiņas vispirms testējiet ar smilškastes atslēgu.

Valodas

GET/api/v1/languages

Valodu beigu punkts sniedz pašlaik pieejamās mērķa un avota valodas ar ISO kodu un pašnosaukumu. Izmantojiet to, nevis fiksētu sarakstu – jaunas valodas tur parādās automātiski.

Patēriņš

GET/api/v1/usage

Patēriņa galapunkts katrai atslēgai parāda tulkotos vārdus un radušās izmaksas par kārtējo mēnesi, kā arī noteikto mēneša limitu. Tos pašus skaitļus jūs varat redzēt grafiski klienta sadaļā zem „API un patēriņš“.

Kļūdu kodi

Kļūdas nāk kā JSON ar laukiem error (mašīnlasāms kods) un message (apraksts). Apstrādājiet vismaz šādus gadījumus:

Ierobežojumi un taisnīgums

Pēc noklusējuma ir spēkā 60 pieprasījumi minūtē un atslēgai, kā arī 30 000 rakstzīmes vienā pieprasījumā; smilškastes atslēga ir papildus ierobežota ar testa kvotu. Augstākus ierobežojumus mēs atbloķējam pēc īsas pārbaudes – sazinieties ar mums, norādot savu lietošanas gadījumu.

Vārdu skaitīšana: Tiek skaitīti avota teksta vārdi (Unicode vārdu robežas), vienreiz katrai mērķvalodai. Html un json formātos tiek skaitīti tikai tulkojamie teksta mezgli vai virkņu vērtības – iezīmes, atslēgas un mainīgie neko nemaksā.

Datu aizsardzība

Apstrāde tikai pakalpojumu sniegšanai ES serveros; saturs netiek izmantots modeļu apmācībai un tiek dzēsts no apstrādes protokoliem pēc 30 dienām. Ražošanas lietošanai mēs noslēdzam apstrādes līgumu saskaņā ar VDAR 28. pantu – sīkāka informācija Trust Center.

Nesūtiet caur smilškasti nekādus reālus personas datus. Pseidonimizējiet testa saturu vai izmantojiet sintētiskus piemērus.

Izmaiņu žurnāls

2026. gada jūlijs

Publiskās smilškastes palaišana: tulkošanas, partijas, glosārija, valodu un patēriņa galapunkti.

Plānots

Ražošanas atslēgu pašpārvalde, stila profili katram zīmolam, tulkošanas atmiņa katram kontam.

API ir versionēta zem /v1; atpakaļsaderīgi paplašinājumi (jauni izvēles lauki, jaunas valodas) tiek veikti bez versijas maiņas. Pārraujošas izmaiņas tiek ieviestas kā jauna versija ar vismaz divpadsmit mēnešu paralēlo darbību.