api.transglot.ai/v1బేరర్ టోకెన్, ఒక ప్రాజెక్ట్రిఫరెన్స్

ఒక ఫైల్‌ను పుష్ చేయండి. ప్రతి భాషను తిరిగి పొందండి.

మీ అప్లికేషన్‌ను అనువదించడానికి REST API. ఒక POST సోర్స్ ఫైల్‌ను అప్‌లోడ్ చేస్తుంది, ఒక GET పూర్తయిన లోకేల్‌ను తిరిగి తెస్తుంది మరియు బేరర్ టోకెన్ మొత్తం అథెంటికేషన్. HTTPతో మాట్లాడే ఏదైనా దీనిని నడపగలదు.

లో: ఒక కాల్

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

బయటకు

300,000

స్టార్టర్‌లో నెలకు పదాలు, టోకెన్‌ను సృష్టించగల మొదటి ప్లాన్.

ఉచితంగా ప్రారంభించండి డెవలపర్ సర్ఫేస్‌ను చూడండి

టోకెన్‌కు నిమిషానికి 60 రిక్వెస్ట్‌లు · ప్రతి 429 Retry-Afterను కలిగి ఉంటుంది · CI మరియు ప్రొడక్షన్‌కు విడివిడి టోకెన్‌లను ఇవ్వండి

కన్సోల్ ఒక API క్లయింట్

పుష్, అనువాదం, గేట్ మరియు పుల్, ప్రతి ఒక్కటి REST ఎండ్‌పాయింట్.

క్రింద ఉన్న చిత్రంలోని ప్రతి వరుసకు వెనుక ఒక రూట్ ఉంది: పుష్, గేట్స్, గ్లాసరీ, బ్యాచ్‌లు మరియు పుల్, అన్నీ ప్రాజెక్ట్ టోకెన్‌తో మీ స్వంత కోడ్ నుండి అందుబాటులో ఉంటాయి. కన్సోల్‌లోని API ప్లేగ్రౌండ్ రీడ్-ఓన్లీ వాటిని మీ ప్రాజెక్ట్‌పై లైవ్‌గా రన్ చేస్తుంది, కాబట్టి మీరు ముందుగా నిజమైన రెస్పాన్స్‌ను చూస్తారు.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

మీరు సోర్స్ ఫైల్‌ను అప్‌లోడ్ చేస్తారు
POST/v1/push
గేట్స్ ప్యానెల్ నిండుతుంది
POST/v1/qa/run
మీరు ఒక పదాన్ని లాక్ చేస్తారు
POST/v1/glossary
బ్యాచ్ వ్యూ స్వయంగా పోల్ చేస్తుంది
GET/v1/batches/:id
మీరు అనువాదాలను తిరిగి తీసుకుంటారు
GET/v1/pull

ప్రతి ప్యానల్‌కు ఒక రూట్, నిమిషానికి 60, టోకన్‌కు సామర్థ్యాలు · మీ అనువాదాలను బయటకు పంపడం కూడా ఒక ఎండ్‌పాయింట్

ఇది కేవలం HTTP మాత్రమే

జట్లు మొదట నిర్మించే నాలుగు విషయాలు.

ప్రతి ఒక్కటి ఒకే ఎండ్‌పాయింట్ మరియు ప్రాజెక్ట్ టోకన్ · ఏదీ ఒక రోజంతా తీసుకోదు

మెర్జ్ గేట్ · ఒక వర్క్‌ఫ్లో ఫైల్

అనువాదం విఫలమైనప్పుడు పుల్ రిక్వెస్ట్‌ను రెడ్‌గా మార్చండి.

క్రాన్ · రాత్రిపూట

విడుదల నోట్స్‌ను ప్రతి రాత్రి అనువదించండి.

బాట్ · ఒక సబ్‌స్క్రిప్షన్

బ్యాచ్ పూర్తయిన వెంటనే Slackలో పోస్ట్ చేయండి.

ఏజెంట్ · MCP

మీకు ఉన్న అదే 17 టూల్స్‌ను AI ఏజెంట్‌కు ఇవ్వండి.

నిమిషానికి రిక్వెస్ట్‌లు

ఖాతాకు కాకుండా, టోకన్‌కు · ప్రతి 429లో ఎన్ని సెకన్లు వేచి ఉండాలనే వివరాలతో Retry-After హెడర్ ఉంటుంది.

ఫైల్ ఫార్మాట్‌లు

మీ రిపోజిటరీ ఇప్పటికే ఉపయోగిస్తున్న ఫార్మాట్‌ను పుష్ మరియు పుల్ చేయండి. బహువచనాలు మరియు ప్లేస్‌హోల్డర్‌లు రెండు దిశలలోనూ సురక్షితంగా ఉంటాయి. ఏదైనా కాల్‌లో format=తో దీనిని నామకరణం చేయండి.

వెబ్‌హుక్ ఈవెంట్‌లు

మొత్తం కేటలాగ్, నిజమైన డెలివరీ ఆకృతిలోనే ఉదాహరణ పేలోడ్‌తో కూడి ఉంటుంది. GET /v1/webhooks/events.

MCP టూల్స్

curlకు బదులుగా ఏజెంట్ రన్‌టైమ్‌కు ఇచ్చే అదే ప్రాజెక్ట్ టోకన్. npx -y @transglot/mcp.

తరచుగా అడిగే ప్రశ్నలు

మొదటి రిక్వెస్ట్‌కు ముందు డెవలపర్లు అడిగే ప్రశ్నలు.

Transglot APIతో నేను ఎలా ప్రామాణీకరించాలి?

బేరర్ టోకన్ పంపండి: Authorization: Bearer $TRANSGLOT_TOKEN. టోకన్ ఒక ప్రాజెక్ట్‌కు చెందుతుంది, కాబట్టి పాత్‌లో ప్రాజెక్ట్ ID లేదు మరియు ఖాతా స్థాయి కీ లీక్ అవ్వదు. మీరు ప్రాజెక్ట్ పేజీలో టోకన్‌లను సృష్టిస్తారు మరియు ప్రతి టోకన్‌కు దాని సొంత సామర్థ్యాలు ఉంటాయి: పుష్, పుల్, మేనేజ్, రీడ్, రైట్.

API ఉచితమా?

కాదు. బేరర్ టోకన్ నెలకు $19తో స్టార్టర్ ప్లాన్‌లో ప్రారంభమవుతుంది. ఉచితం కన్సోల్‌ను కవర్ చేస్తుంది, ఇది ఉత్పత్తి సరిపోతుందో లేదో చూడడానికి సరిపోతుంది, కానీ ఇది టోకన్‌ను సృష్టించలేదు. CLI, GitHub Action, వెబ్‌హుక్స్, MCP మరియు డెలివరీ బండిల్ అన్నీ ఆ టోకన్ వెనుకే ఉంటాయి, కాబట్టి అవి కలిసి వస్తాయి.

Transglotకు స్ట్రింగ్‌లను ఎలా అప్‌లోడ్ చేయాలి?

ఫైల్ మరియు దాని ఫార్మాట్‌తో POST /v1/push, ఉదాహరణకు -F "file=@lang/en.json" -F "format=laravel_json". ఇది 202తో స్పందించి బ్యాచ్‌ను క్యూలో ఉంచుతుంది. వాస్తవంగా మారిన వరుసలు మాత్రమే అనువదించబడతాయి, కాబట్టి మార్పులేని ఫైల్‌ను పుష్ చేయడం వల్ల ఖర్చు లేదు.

నా అనువాదాలను ఎలా తిరిగి పొందాలి?

20 ఫార్మాట్‌లలో ఏదైనా ఒకటి, మీకు కావలసినప్పుడు GET /v1/pull. ఇది CLI ర్యాప్ చేసే ఎండ్‌పాయింట్ మరియు API ప్లేగ్రౌండ్ లైవ్‌గా నడిపేది. ఎగుమతి రిక్వెస్ట్ ఫైల్ చేయనవసరం లేదు మరియు డేటా మీ సొంతం కాకుండా పోయే విండో లేదు.

API రేట్ లిమిట్ అంటే ఏమిటి?

ఒక నిమిషానికి 60 రిక్వెస్టులు, ఇది ఖాతా ప్రకారం కాకుండా టోకన్ ప్రకారం లెక్కించబడుతుంది. దీనిని మీరినట్లయితే, ఎన్ని సెకన్లు వేచి ఉండాలనే వివరాలతో Retry-After హెడర్‌తో కూడిన 429 ఎర్రర్ వస్తుంది మరియు ఏదీ చార్జ్ చేయబడదు లేదా పాక్షికంగా రాయబడదు. CI మరియు ప్రొడక్షన్ కోసం వేర్వేరు టోకన్‌లను ఉపయోగించండి, తద్వారా శబ్దంతో కూడిన బిల్డ్ మీ అప్లికేషన్‌ను ఆపివేయదు.

API ఏ భాషలకు మద్దతు ఇస్తుంది?

నిర్దిష్ట జాబితా లేదు. ICU గుర్తించే ఏ BCP-47 ట్యాగ్‌నైనా వాలిడేటర్ అంగీకరిస్తుంది, ఇది తనిఖీ చేసే పట్టికలో 708 లోకేల్‌లను కలిగి ఉంటుంది, దానికి వెలుపల ఉన్న ట్యాగ్‌ల కోసం స్ట్రక్చరల్ ఫాల్‌బ్యాక్ కూడా ఉంటుంది. ప్రాజెక్ట్‌కు ఒక లోకేల్‌ను జోడిస్తే, తదుపరి పుష్‌లో అది చేర్చబడుతుంది.

నేను ఏ ఫైల్ ఫార్మాట్‌లను పుష్ మరియు పుల్ చేయగలను?

ఇరువది: JSON ఫ్లాట్ మరియు నెస్టెడ్, Laravel PHP మరియు JSON, Android XML, iOS .strings, .stringsdict మరియు .xcstrings, Flutter ARB, XLIFF 1.2 మరియు 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV మరియు Unreal PO. వీటిలో ఏడు ఫార్మాట్‌లు ప్లూరల్స్‌ను కలిగి ఉంటాయి మరియు ఫైల్ వెళ్ళిన ఆకృతిలోనే తిరిగి వస్తుంది.

Transglot‌లో వెబ్‌హుక్‌లు ఉన్నాయా?

అవును. batch.completed, translation.reviewed, qa.completed మరియు source_drift.repaired వంటి 12 వెబ్‌హుక్ ఈవెంట్‌లు ఉన్నాయి. మీరు ధృవీకరించుకోవడానికి ప్రతి డెలివరీ టైమ్‌స్టాంప్ హెడర్‌తో HMAC సైన్ చేయబడి ఉంటుంది మరియు GET /v1/webhooks/events ప్రతి ఒక్కటికి సాంపిల్ పేలోడ్‌తో క్యాటలాగ్‌ను తిరిగి ఇస్తుంది.

AI ఏజెంట్‌ల కోసం MCP సర్వర్ ఉందా?

అవును. npx -y @transglot/mcp మీ ప్రాజెక్ట్ టోకెన్ పై 17 టూల్స్‌ను ఎక్స్‌పోజ్ చేస్తుంది, కాబట్టి అసిస్టెంట్ అనువాదాన్ని చదవగలదు, రాయగలదు, భాషను జోడించగలదు, రన్‌ను ప్రారంభించగలదు, బ్యాచ్‌ను తనిఖీ చేయగలదు లేదా నిఘంటువును సవరించగలదు. ఇది అదే API మరియు అదే అనుమతులు, curl నుండి కాకుండా ఏజెంట్ రన్‌టైమ్ నుండి చేరుకోబడుతుంది.

నేను దీనిని CIలో రన్ చేయగలనా?

అవును. GitHub Action (transglot/transglot-action@v1) మరియు CLI రెండూ ఈ ఎండ్‌పాయింట్‌లను ర్యాప్ చేస్తాయి. ఒక వరుస తిరస్కరించబడినప్పుడు, transglot push --wait 4తో నిష్క్రమిస్తుంది మరియు ఆ రన్‌పై Action దాని జాబ్‌ను విఫలం చేస్తుంది. మెర్జ్‌ను ఆపడానికి, దాని కమిట్ ఇన్‌పుట్‌ను noneకి సెట్ చేసి పుల్ రిక్వెస్ట్‌లపై దాన్ని రన్ చేయండి, లాగిన ఫైల్‌లో కీ లేనప్పుడు విఫలమయ్యే స్టెప్‌ను జోడించండి మరియు జాబ్‌ను బ్రాంచ్ ప్రొటెక్షన్‌లో అవసరమైన తనిఖీగా మార్చండి.

ట్రాన్స్‌లేషన్ క్వాలిటీ చెక్‌ను ఫెయిల్ చేసినప్పుడు ఏమి జరుగుతుంది?

ప్లేస్‌హోల్డర్‌లు, బహువచనాలు, నిఘంటు పదాలు మరియు పొడవు: నాలుగు డిటర్మినిస్టిక్ గేట్‌లు ప్రతి వరుసను చదువుతాయి. పాడైన ప్లేస్‌హోల్డర్, తప్పిపోయిన బహువచన రూపం లేదా నిషేధిత నిఘంటు పదం ఒక స్వయంచాలక సవరణ రీట్రైని పొందుతుంది, మరియు అది ఇంకా విఫలమైతే వరుస రాయబడకుండా తిరస్కరించబడుతుంది. పొడవు మాత్రమే మించిన వరుస తిరస్కరించబడకుండా రాయబడుతుంది. GET /v1/batches/:id?include=failures తిరస్కరించబడిన వరుసలను మరియు కారణాలను జాబితా చేస్తుంది.

API ఎప్పటికైనా నా ఇంటిగ్రేషన్‌ను బ్రేక్ చేస్తుందా?

కాదు. /v1 ఎప్పుడూ ఎండ్‌పాయింట్‌లు మరియు రెస్పాన్స్ ఫీల్డ్‌లను మాత్రమే పొందుతుంది; మీరు ఇప్పటికే పార్స్ చేసిన ఫీల్డ్ ఆకృతి మారదు లేదా మాయం కాదు. బ్రేకింగ్ ఛేంజ్ కొత్త వర్షన్ ప్రిఫిక్స్ కింద విడుదల అవుతుంది, ఇది రిజర్వ్ చేయబడింది మరియు ఇంకా ఖాళీగా ఉంది. API చేంజ్‌లాగ్ ప్రతి విడుదలను రికార్డ్ చేస్తుంది.

మీరు ఇప్పటికే నడుపుతున్న వాటితో పనిచేస్తుంది