Doiciméadú API

Réamhrá

Aistríonn an API Aistriúcháin téacs, HTML agus JSON struchtúrtha go dtí suas le 24 teanga oifigiúla AE. Is í JSON (UTF-8) formáid na n-iarratas agus na bhfreagraí. Roghnaíonn gach iarratas leibhéal cáilíochta: bunúsach (AI), gairmiúil (AI le forfheidhmiú téarmaíochta) nó athbhreithniú (seiceáil samplach dhúchais bhreise, neamhshioncronach).

Chun triail a bhaint as, bain úsáid as an eochair bhosca gainimh phoiblí ón limistéar custaiméirí – oibríonn sí cosúil le táirgeadh, ach tá sí teoranta do chuóta tástála. Faigheann tú eochracha táirgeachta tar éis gníomhachtú gearr trí do chuntas custaiméara.

Eochair phoiblí bosca gainimhbd_test_sandbox_2026

Fíordheimhniú

Iompraíonn gach iarratas d'eochair API sa cheanntásc Údaraithe mar Chomhartha Iompróra. Tosaíonn eochracha le bd_test_ (bosca gainimh) nó bd_live_ (táirgeadh). Caith le heochracha mar fhocail faire: riamh i gcód tosaigh, riamh sa stór – má tá amhras ort faoi chomhréiteach, cúlghair agus gineadh sa limistéar custaiméirí.

Freagraíonn an API le stádas 401 ar iarratais gan eochair bhailí. Is féidir teorainn mhíosúil i bhfocail a chur le heochair ag am ar bith; nuair a shroichtear é, freagraíonn an API le stádas 402 go dtí go n-ardóidh tú an teorainn.

Authorization: Bearer bd_live_ihr_schluessel

Aistrigh téacs

POST/api/v1/translate

Aistríonn an críochphointe lárnach téacs amháin nó níos mó go teanga sprice. Rialaíonn an réimse formáid an chóireáil: text (caighdeán), html (fanann marcáil), nó json (aistrítear luachanna teaghrán amháin, fanann eochracha agus struchtúr gan athrú).

Tá na haistriúcháin san ord ionchuir, na focail fhoinse comhairimh, agus na costais ríofa i gcent san fhreagra. Leis an gceanntásc roghnach Idempotency-Key, cuireann tú cosc ar phróiseáil dhúbailte ar athdhéanamh líonra: soláthraíonn eochracha comhionanna an chéad fhreagra stóráilte.

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"
}

Paraiméadar

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);

Baisc & Gréasáin

POST/api/v1/batches

Chun méideanna móra nó an chéim athbhreithnithe, oibrigh go haisincronach: Glacann an críochphointe Baisce suas le 1,000 téacs agus freagraíonn sé láithreach le hAitheantas Poist. Nuair a bheidh an post críochnaithe – i gcás athbhreithnithe tar éis an tsampla ón gcainteoir dúchais – glaoíonn an API ar do URL gréasáin a taifeadadh le toradh.

Tá glaonna Gréasáin sínithe le ceanntásc HMAC-SHA-256, ar féidir leat a fhíorú le do rún gréasáin. Mura bhfreagraíonn do fhreastalaí le stádas 2xx, déanfar an seachadadh a athrá suas le cúig huaire le eatramh méadaitheach; fanann poist ar fáil ar feadh 30 lá breise trí GET.

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

Gluaiseanna

POST/api/v1/glossaries

Cinntíonn gluaiseanna do théarmaíocht: gach iontráil le téarma foinse agus a aistriúchán ceangailteach in aghaidh teanga sprioc. Uaslódáiltear mar CSV i limistéar an chliaint nó trí API; leagann na leibhéil pro agus review na meaitseanna i bhfeidhm go ceangailteach, úsáideann basic mar mholadh iad.

In aghaidh an chuntais, is féidir suas le 20 gluais le 5,000 iontráil an ceann. Bíonn tionchar díreach ag athruithe ar gach iarratas ina dhiaidh sin – dá bhrí sin, leaganáil gluaiseanna mar a dhéanfá le cód agus tástáil athruithe ar dtús leis an eochair bosca gainimh.

Teangacha

GET/api/v1/languages

Soláthraíonn an críochphointe teangacha na teangacha sprioc agus foinse atá ar fáil faoi láthair le cód ISO agus ainm dúchais. Úsáid é in ionad liosta seasta – feictear teangacha nua ann go huathoibríoch.

Tomhaltas

GET/api/v1/usage

Taispeánann an críochphointe tomhaltais na focal aistrithe agus na costais a thabhaigh an mhí seo caite de réir eochrach, chomh maith leis an teorainn mhíosúil atá leagtha síos. Feiceann tú na huimhreacha céanna go grafach i limistéar an chustaiméara faoi „API & Tomhaltas“.

Cóid earráide

Tagann earráidí mar JSON le réimsí error (cód inléite ag meaisín) agus message (cur síos). Déileáil leis na cásanna seo ar a laghad:

Teorainneacha & Cothroime

Go caighdeánach, bíonn 60 iarratas in aghaidh an nóiméid agus 30,000 carachtar in aghaidh an iarratais i bhfeidhm; tá an eochair Sandbox teoranta don chuóta tástála freisin. Scaoilfimid teorainneacha níos airde tar éis seiceála gearr – déan teagmháil linn le do chás úsáide.

Comhaireamh focal: Déantar focail an téacs fhoinse (teorainneacha focal Unicode) a chomhaireamh in aghaidh na spríochteanga uair amháin. I gcás formáidí html agus json, ní áirítear ach nóid téacs inaistrithe nó luachanna teaghráin – níl aon chostas ar mharcáil, eochracha ná athróga.

Cosaint Sonraí

Próiseáil go heisiach chun seirbhís a sholáthar ar fhreastalaithe AE; ní úsáidtear ábhar chun samhlacha a oiliúint agus scriostar é ó logaí próiseála tar éis 30 lá. Le haghaidh úsáid táirgeachta, déanaimid conradh próiseála sonraí a thabhairt i gcrích de réir Airteagal 28 RGCS – sonraí san Ionad Iontaobhais.

Ná seol fíorshonraí pearsanta tríd an mbosca gainimh. Déan ábhar tástála a ainmniú go bréagach nó bain úsáid as samplaí sintéiseacha.

Log Athruithe

Iúil 2026

Tús an bhosca gainimh phoiblí: Críochphointe Aistriúcháin, Baisc, Glóis, Teangacha agus Tomhaltais.

Pleanáilte

Féinbhainistíocht eochracha táirgeachta, próifílí stíle in aghaidh branda, cuimhne aistriúcháin (Translation Memory) in aghaidh cuntais.

Tá an API leaganaithe faoi /v1; déantar síneadh comhoiriúnach ar gcúl (réimsí roghnacha nua, teangacha nua) gan athrú leagain. Tagann athruithe briste i bhfoirm leagain nua le ar a laghad dhá mhí dhéag d'oibríocht chomhthreomhar.