api.transglot.ai/v1bearer-token, yksi projektiviite

Lataa tiedosto. Hanki kaikki kielet takaisin.

REST API sovelluksesi kääntämiseen. Yksi POST-lähetys lataa lähdetiedoston, yksi GET-haku palauttaa valmiin kielen, ja bearer-token riittää todennukseen. Mikä tahansa HTTP-yhteyksiä tukeva järjestelmä voi käyttää sitä.

sisään: yksi kutsu

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

ulos

300,000

sanaa kuukaudessa Starter-tilauksella, ensimmäinen tilaus, joka voi luoda tokenin.

Aloita ilmaiseksi Katso kehittäjän näkymä

60 pyyntöä minuutissa per token · jokainen 429-virhe sisältää Retry-After-otsakkeen · anna CI:lle ja tuotantoympäristölle omat tokenit

konsoli on API-asiakas

Lataa, käännä, tarkista ja hae, jokainen oma REST-päätepiste.

Jokaisella alla olevan kuvan rivillä on taustalla reitti: lataus, tarkistukset, sanasto, erät ja haku, kaikki saavutettavissa omasta koodistasi projektin tokenilla. Konsolin API-leikkikenttä ajaa vain luku -toiminnot live-tilassa projektiisi nähden, joten näet aidon vastauksen ensin.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Lataat lähdetiedoston
POST/v1/push
Tarkistuspaneeli täyttyy
POST/v1/qa/run
Lukitset termin
POST/v1/glossary
Eränäkymä hakee tietoja itsestään
GET/v1/batches/:id
Haet käännökset takaisin
GET/v1/pull

yksi reitti per paneeli, 60 minuutissa, oikeudet per tunnus · käännösten ulosvienti on myös päätepiste

se on vain http

Neljä asiaa, jotka tiimit rakentavat ensin.

jokainen on yksittäinen päätepiste ja projektitunnus · mikään niistä ei vaadi iltapäivää

yhdistämisportti · yksi työnkulutiedosto

Muuta vetopyyntö punaiseksi, kun käännös epäonnistuu.

cron · joka yö

Käännä julkaisutiedotteet yön aikana, joka yö.

bot · yksi tilaus

Lähetä viesti Slackiin heti, kun erä valmistuu.

agentti · mcp

Anna tekoälyagentille samat 17 työkalua kuin sinulla on.

pyyntöä minuutissa

per tunnus, ei per tili, Retry-After-otsakkeella jokaisessa 429-vastauksessa, joka kertoo odotettavan sekuntimäärän.

tiedostomuodot

lähetä ja hae muodossa, jota arkistosi jo käyttää. Monikot ja paikkamerkit säilyvät molempiin suuntiin. Nimeä se format=-parametrilla kummassakin kutsussa.

webhook-tapahtumat

koko luettelo, kukin esimerkkisisällöllä täsmälleen siinä muodossa, jonka todellinen toimitus sisältää. GET /v1/webhooks/events.

mcp-työkalut

sama projektitunnus, annettu agentin ajonaikaympäristölle curlin sijaan. npx -y @transglot/mcp.

UKK

Mitä kehittäjät kysyvät ennen ensimmäistä pyyntöä.

Miten todennan Transglot API:n?

Lähetä bearer-token: Authorization: Bearer $TRANSGLOT_TOKEN. Token kuuluu yhteen projektiin, joten polussa ei ole projektin tunnusta eikä vuotavaa tilikohtaista avainta. Luot tokenit projektisivulla ja kukin niistä sisältää omat oikeutensa: push, pull, manage, read, write.

Onko API ilmainen?

Ei. Bearer-token alkaa Starter-suunnitelmasta hintaan 19 $ kuukaudessa. Ilmainen versio kattaa konsolin, mikä riittää tuotteen sopivuuden arviointiin, mutta sillä ei voi luoda tokenia. CLI, GitHub Action, webhookit, MCP ja toimituspaketti ovat kaikki saman tokenin takana, joten ne saapuvat yhdessä.

Miten lataan merkkijonoja Transglotiin?

POST /v1/push tiedoston ja sen muodon kanssa, esimerkiksi -F "file=@lang/en.json" -F "format=laravel_json". Vastaus on 202 ja erä asetetaan jonoon. Vain todelliset muutokset käännetään, joten muuttumattoman tiedoston lähettäminen ei maksa mitään.

Miten saan käännökseni ulos?

GET /v1/pull, missä tahansa 20 muodosta, milloin vain. Tämä on päätepiste, jonka CLI kietoo ympärilleen, ja jota API-leikkikenttä ajaa reaaliajassa. Ei vientipyyntöjä tiedostoihin eikä aikarajoja, joiden aikana tietosi lakkaavat olla omiasi.

Mikä on API:n nopeusrajoitus?

60 pyyntöä minuutissa, laskettuna tokenia eikä tiliä kohti. Ylityksestä saat 429-virheen Retry-After-otsakkeella, joka kertoo odotussekunnit, eikä mitään veloiteta tai kirjoiteta puolivalmiiksi. Anna CI:lle ja tuotannolle erilliset tokenit, jottei häiriöaltis rakennus nälkiytä sovellustasi.

Mitä kieliä API tukee?

Ei ole kiinteää listaa. Validoija hyväksyy minkä tahansa BCP-47-tunnisteen, jonka ICU tunnistaa; se tarkistaa 708 paikallismuotoa taulukostaan ja tarjoaa rakenteellisen varajärjestelmän sen ulkopuolisille tunnisteille. Lisää paikallismuoto projektiin, ja seuraava push sisällyttää sen.

Mitä tiedostomuotoja voin työntää ja hakea?

Kaksikymmentä: JSON (tasainen ja sisäkkäinen), Laravel PHP ja JSON, Android XML, iOS .strings, .stringsdict ja .xcstrings, Flutter ARB, XLIFF 1.2 ja 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV ja Unreal PO. Seitsemän niistä tukee monikkoja, ja tiedosto palautuu samassa muodossa kuin se lähetettiin.

Onko Transglotissa webhookeja?

Kyllä. Webhook-tapahtumia on 12, mukaan lukien batch.completed, translation.reviewed, qa.completed ja source_drift.repaired. Jokainen toimitus on HMAC-varmistettu aikaleimaotsakkeella, joten voit vahvistaa sen, ja GET /v1/webhooks/events palauttaa luettelon näytetietosisällöllä kullekin tapahtumalle.

Onko olemassa MCP-palvelin tekoälyagenteille?

Kyllä. npx -y @transglot/mcp tarjoaa 17 työkalua projektisi tunnuksen kautta, joten avustaja voi lukea käännöksen, kirjoittaa sen, lisätä kielen, aloittaa ajon, tarkistaa erän tai muokata sanastoa. Se on sama API ja samat oikeudet, mutta käytettynä agentin ajoajasta curlin sijaan.

Voinko ajaa sitä CI:ssä?

Kyllä. GitHub-toiminto (transglot/transglot-action@v1) ja CLI kietovat nämä päätepisteet. Kun rivi hylätään, transglot push --wait palauttaa virhekoodin 4 ja toiminto epäonnistuu kyseisessä ajossa. Yhdistämisen estämiseksi suorita se vetopyynnöissä siten, että commit-syöte on asetettu arvoon none, lisää vaihe, joka epäonnistuu, jos puuttuvasta tiedostosta puuttuu avain, ja määritä työ pakolliseksi tarkistukseksi haaran suojausasetuksissa.

Mitä tapahtuu, kun käännös epäonnistuu laatutarkistuksessa?

Neljä determinististä porttia lukee jokaisen rivin: paikkamerkit, monikot, sanastotermit ja pituus. Rikkoutunut paikkamerkki, puuttuva monikkomuoto tai kielletty sanastotermi saa yhden automaattisen korjausyrityksen, ja jos se edelleen epäonnistuu, rivi hylätään eikä sitä kirjoiteta. Rivi, joka ylittää vain pituusrajan, kirjoitetaan eikä hylätä. GET /v1/batches/:id?include=failures listaa hylätyt rivit ja syyt.

Rikkooko API koskaan integraationi?

Ei. /v1 saa ainoastaan uusia päätepisteitä ja vastauskenttiä; jo parsimasi kenttä ei muuta muotoaan tai katoa. Rikkova muutos julkaistaisiin uuden version etuliitteen alla, joka on varattu ja yhä tyhjä. API:n muutosloki kirjaa jokaisen julkaisun.