added
డిప్లాయ్-కీ మోడల్, ఇక్కడ బేరర్ టోకెన్ ప్రాజెక్ట్నే సూచిస్తుంది. CLI మరియు GitHub Action రెండూ దీనిపైనే పనిచేస్తాయి.
api v1 · ప్రస్తుతం
API చేంజ్‌లాగ్.
ఏదీ తీసివేయబడలేదు.
/v1లో ఎప్పుడూ కొత్త అంశాలు మాత్రమే జోడించబడతాయి. కొత్త ఎండ్పాయింట్లు మరియు కొత్త రెస్పాన్స్ ఫీల్డ్‌లు అదే ప్రిఫిక్స్‌లో చేరుతాయి, మీరు ఇప్పటికే పార్స్ చేస్తున్న ఫీల్డ్ యొక్క నిర్మాణం లేదా ఉనికి ఎప్పుడూ మారదు. బ్రేకింగ్ మార్పు ఏదైనా ఉంటే, అది కొత్త వెర్షన్ ప్రిఫిక్స్ కింద విడుదల చేయబడుతుంది, ఇది ప్రస్తుతం రిజర్వ్ చేయబడి ఖాళీగా ఉంది.
v1/api/v1
ఉపయోగంలో ఉన్న ఏకైక ప్రిఫిక్స్
ఉపయోగంలో ఉన్న ఏకైక ప్రిఫిక్స్
5 విడుదలలు
11 మార్పులు, వాటిలో ఏదీ బ్రేకింగ్ కాదు
లాగ్ యొక్క స్వరూపం
ఒకే వెర్షన్ ప్రిఫిక్స్, ఏ తొలగింపులు లేవు.
ఈ నాలుగు అంశాలలో మూడు ఈ లాగ్‌కు సంబంధించిన లక్షణాలు. నాల్గవది API అందించే వెబ్‌హుక్ క్యాటలాగ్ పరిమాణం.
5
/v1పై విడుదలలు, ప్రతి ఒక్కటీ అడిటివ్‌గా (కొత్తవి జోడించబడే విధంగా) ఉంటాయి
1
ఉపయోగంలో ఉన్న వెర్షన్ ప్రిఫిక్స్. తదుపరిది రిజర్వ్ చేయబడి ఖాళీగా ఉంది
0
API విడుదలైనప్పటి నుండి బ్రేకింగ్ మార్పులు
12
సంతకం చేయబడిన వెబ్‌హుక్ ఇవెంట్స్. మూలం: App\Enums\WebhookEvent
సెమ్‌వర్ ద్వారా కాకుండా, విడుదల ఆధారంగా తేదీలు
ప్రయాణించడానికి ఆరో కీలను ఉపయోగించండి
2026-07-08
CDN డెలివరీ, వినియోగం మరియు ప్లేగ్రౌండ్
July 8, 2026 · 4 మార్పులు
05 / 05
added
/v1/incontext/translations, /screenshots మరియు /suggest విజువల్ ఎడిటర్ను నడుపుతాయి, CORS ఆ ప్రిఫిక్స్కు మాత్రమే పరిమితం చేయబడి ఉంటుంది.
POST /v1/incontext/session ఒక పబ్లిష్ చేయదగిన కీ మరియు ఒక Originని స్కోప్ చేయబడిన సెషన్ టోకెన్‌తో మారుస్తుంది.
improved
ద్విభాషా ఎక్స్పోర్ట్ ఇప్పుడు సోర్స్ టెక్స్ట్ను నిశ్శబ్దంగా భర్తీ చేయకుండా, ఏది రౌండ్-ట్రిప్ చేయలేకపోయిందో నివేదిస్తుంది. ఇప్పటికే ఉన్న ఫీల్డ్‌లు మారవు, అందుకే దీన్ని హెడర్‌లో ఉంచడం జరిగింది.
GET /v1/pullకు X-Skipped-Keys మరియు X-Missing-Source-Keys రెస్పాన్స్ హెడర్లు జోడించబడ్డాయి.
added
అలాగే /v1/glossary/import, /export మరియు /extract, తద్వారా కన్సోల్ తెరవకుండానే టర్మ్ బేస్ను లోపలికి మరియు బయటికి తరలించవచ్చు.
APIపై పూర్తి టర్మ్-బేస్ CRUD: /v1/glossaryపై GET, POST, PUT మరియు DELETE.
added
ఫైండింగ్స్ మీరు ఇప్పటికే తీసుకువచ్చే ట్రాన్స్లేషన్ వరుసలలో చేరుతాయి, కాబట్టి కొత్తగా ఏమీ పోల్ చేయనవసరం లేదు.
POST /v1/qa/run అనేది ఏజెంటిక్ క్వాలిటీ పాస్‌ను ప్రారంభించి, రన్ హ్యాండిల్‌ను తిరిగి ఇస్తుంది.
added
ఎండ్పాయింట్ ప్రకారం సబ్స్క్రైబ్ చేయండి. జాబితా App\Enums\WebhookEventలో ఉంటుంది, ఇందులో ప్రస్తుతం పన్నెండు కేసులు ఉన్నాయి; ఈ వరుసకు బదులు ఎన్యూమ్ను లెక్కించండి.
సైన్డ్ వెబ్హుక్స్ కీ, ట్రాన్స్లేషన్, లాంగ్వేజ్, గ్లాసరీ మరియు QA ఈవెంట్స్ను అసలు బ్యాచ్ జతతో పాటు విడుదల చేస్తాయి.
improved
డెలివరీలో ఒక కౌంట్ మరియు గరిష్టంగా ఇరవై నమూనాలు ఉంటాయి, మార్చబడిన వరుసకు ఒక కాల్ కాదు. డెలివరీ లాగ్లు ప్రతి ప్రయత్నాన్ని తదుపరి రీట్రై సమయంతో పాటు రికార్డ్ చేస్తాయి.
translation.updated వంటి అధిక-ఫ్రీక్వెన్సీ ఈవెంట్స్ ఒక విండోలో ఒక డెలివరీగా కలిసిపోతాయి, కాబట్టి బల్క్ ఎడిట్ ఎండ్పాయింట్ను ఎప్పుడూ ముంచెత్తదు.
added
ఇది ETag మరియు స్వల్ప-కాలిక కాషేను తిరిగి ఇస్తుంది మరియు If-None-Matchను 304తో గౌరవిస్తుంది. /v{n} కింద ఉన్న ఇమ్మ్యూటబుల్ సిబ్లింగ్ కంటెంట్ అడ్రెస్డ్ మరియు ఒక సంవదరానికి కాష్ చేయబడింది.
ఒక పబ్లిక్, ఎడ్జ్-కాషబుల్ GET /v1/cdn/{project}/{locale} మీ ప్రచురించిన స్ట్రింగ్‌లను అందిస్తుంది.
added
CIలో POST /v1/cdn/publishతో దీన్ని ట్రిగ్గర్ చేయండి మరియు X-Transglot-Cdn-Key హెడర్‌లో నిర్దిష్ట రీడ్-ఓన్లీ కీతో రీడ్‌లను అధికారం ఇవ్వండి. మీ స్వంత CDN వెనుక ఉంచడానికి ఇది సురక్షితం.
ప్రచురణ ప్రస్తుత ట్రాన్స్‌లేషన్‌లను మాన్యువల్‌గా లేదా ప్రతి పుష్‌లో కొత్త ఇమ్మ్యూటబుల్ వెర్షన్‌కు ప్రమోట్ చేస్తుంది.
added
రిక్వెస్ట్ బాడీలు ఏవీ నిల్వ చేయబడవు. ఇది ఒక కౌంట్ మాత్రమే.
ప్రమాణీకరించబడిన ప్రతి /v1 కాల్ టోకన్ ప్రకారం రోజువారీగా లెక్కించబడుతుంది మరియు డిప్లాయ్ హబ్‌లో కనిపిస్తుంది.
improved
ప్రాజెక్ట్, పుల్, బ్యాచ్‌లు మరియు గ్లాసరీ ఎగుమతి. దీన్ని పని చేయడానికి ఏ రిక్వెస్ట్ లేదా రెస్పాన్స్ షేప్ మార్చబడలేదు.
డిప్లాయ్ హబ్ మీ ప్రాజెక్ట్‌పై లైవ్‌గా రీడ్-ఓన్లీ ఎండ్‌పాయింట్‌లను అమలు చేసే API ప్లేగ్రౌండ్‌ను పొందింది.
డిప్రికేషన్ రిజిస్టర్
ఏమీ లేదు దూరంగా వెళ్లడం.
ప్రచురించబడిన ప్రతి సర్ఫేస్‌కు ఒక వరుస, దీన్ని షిప్ చేసిన రిలీజ్‌తో. చివరి కాలమ్ చూడవలసినది: తొలగింపు అక్కడ జరిగే చాలా ముందు తేదీతో కనిపిస్తుంది.
| సర్ఫేస్ | విడుదల చేయబడింది | స్థితి | తీసివేయు తేదీ |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | ప్రస్తుతం | ఏదీ షెడ్యూల్ చేయబడలేదు |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | ప్రస్తుతం | ఏదీ షెడ్యూల్ చేయబడలేదు |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | ప్రస్తుతం | ఏదీ షెడ్యూల్ చేయబడలేదు |
POST /v1/qa/run | June 12, 2026 | ప్రస్తుతం | ఏదీ షెడ్యూల్ చేయబడలేదు |
Signed webhook events, twelve typed cases | June 30, 2026 | ప్రస్తుతం | ఏదీ షెడ్యూల్ చేయబడలేదు |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | ప్రస్తుతం | ఏదీ షెడ్యూల్ చేయబడలేదు |
ఈ పట్టిక నుండి ఏ వరుసనూ ఎప్పుడూ తొలగించరు. ఒక సర్ఫేస్ విరమించబడినా, దాని వరుస ఉంటుంది మరియు ఒక తేదీని పొందుతుంది, ఎందుకంటే మీరు ప్రణాళిక చేసుకోగలిగే తీసివేతను ప్రచురించడమే ప్రధాన ఉద్దేశ్యం.
అనుకూలత వాగ్దానం
మూడు నియమాలు మీరు నిర్మించగలిగేది.
ఆడిటివ్
కొత్త ఎండ్పాయింట్లు మరియు కొత్త రెస్పాన్స్ ఫీల్డ్‌లు /v1 లో విడుదలవుతాయి. మీరు ఇప్పటికే పార్స్ చేసిన ఫీల్డ్ ఆకారం మారదు మరియు అదృశ్యం కాదు.
కొత్త ప్రిఫిక్స్
బ్రేకింగ్ మార్పు ఈ వెర్షన్ లోపల కాకుండా, కొత్త వెర్షన్ ప్రిఫిక్స్ కింద విడుదలవుతుంది. ఆ ప్రిఫిక్స్ రిజర్వ్ చేయబడింది మరియు ఉపయోగించబడలేదు, మరియు v1 పైన ఉన్న ప్రతి విడుదల దానిపైనే ఆధారపడి ఉంది.
నిజాయితీగల హెడర్లు
ఒక పుల్ ఏదైనా రౌండ్-ట్రిప్ చేయలేనప్పుడు, అది హెడర్‌లో తెలియజేస్తుంది. బాడీని మార్చకుండా X-Skipped-Keys మరియు X-Missing-Source-Keys జోడించబడ్డాయి.
తరచుగా అడిగే ప్రశ్నలు
API వెర్షనింగ్ మరియు డిప్రికేషన్ గురించి డెవలపర్లు అడిగే ప్రశ్నలు.
Transglot API వెర్షన్ చేయబడిందా?
అవును, URL ప్రిఫిక్స్ ద్వారా. ఇప్పటివరకు ప్రచురించినవన్నీ /v1 కింద ఉంటాయి, ఇది ఒక్కటే ఉపయోగంలో ఉన్న ప్రిఫిక్స్. ఎటువంటి వెర్షన్ హెడర్, తేదీ పిన్నింగ్ లేదా కాన్ఫిగర్ చేయాల్సిన అంశాలు ఏవీ లేవు.
అప్‌డేట్ వల్ల నా ఇంటిగ్రేషన్ ఎప్పుడైనా విఫలమవుతుందా?
/v1 లోపల కాదు. కొత్త ఎండ్పాయింట్లు మరియు కొత్త రెస్పాన్స్ ఫీల్డ్‌లు జోడించబడతాయి, కానీ మీరు ఇప్పటికే పార్స్ చేస్తున్న ఫీల్డ్ ఆకారం మారదు మరియు అది తొలగించబడదు. ఒక మార్పును అడిటివ్‌గా (additively) చేయలేకపోతే, అది కొత్త ప్రిఫిక్స్ కింద వెళ్తుంది మరియు పాతది పనిచేస్తూనే ఉంటుంది.
ఏదైనా డిప్రికేట్ చేయబడిందా లేదా తొలగించబడిందా?
ఏమీ లేదు, మరియు పై రిజిస్టర్ అలానే చెబుతోంది. ప్రచురించబడిన ప్రతి సర్ఫేస్, అది విడుదలైన రిలీజ్ మరియు "ప్లాన్ చేయబడలేదు" అని చదివే తొలగింపు కాలమ్‌తో జాబితా చేయబడింది.
తొలగింపుకు ఎంత ముందుగానే నోటీసు ఇవ్వబడుతుంది?
తొలగింపు సంభవించడానికి చాలా ముందుగానే ఆ రిజిస్టర్‌లో ఒక తేదీతో కనిపిస్తుంది మరియు ఆ తర్వాత కూడా ఆ వరుస అదృశ్యం కాకుండా టేబుల్‌లోనే ఉంటుంది. మీరు ప్లాన్ చేసుకోగలిగే తేదీనే దీన్ని ప్రచురించడం యొక్క ప్రధాన ఉద్దేశ్యం.
కొత్తది విడుదలైనప్పుడు నాకు ఎలా తెలుస్తుంది?
ఈ పేజీలో ప్రతి విడుదల తేదీతో ఉంటుంది. ఉత్పత్తి చేంజ్‌లాగ్ మిగిలిన అన్ని విడుదలలను కవర్ చేస్తుంది మరియు మీరు చదవని ఏదైనా ఉన్నప్పుడు కన్సోల్ ఒక మార్కర్‌ను చూపిస్తుంది.
API కోసం ప్రత్యేక చేంజ్‌లాగ్ ఎందుకు ఉంది?
ఎందుకంటే API ఒక ఉత్పత్తి విడుదల చేయని అనుకూలత వాగ్దానాన్ని కలిగి ఉంటుంది. ఒక ఇంటిగ్రేషన్ ఇంకా పనిచేస్తుందో లేదో తనిఖీ చేస్తున్న డెవలపర్, తెలుసుకోవడానికి ఫీచర్ పనిని స్క్రోల్ చేయవలసిన అవసరం లేదు.
నా ప్లాన్‌కు APIని ఎలా జోడించాలి?
బేరర్ టోకెన్ నెలకు $19 వద్ద స్టార్టర్ ప్లాన్‌తో ప్రారంభమవుతుంది. ఉచిత ప్లాన్ కన్సోల్‌ను కవర్ చేస్తుంది కానీ టోకెన్‌ను సృష్టించలేదు మరియు CLI, GitHub Action, వెబ్‌హుక్‌లు మరియు MCP అన్నీ ఆ టోకెన్ వెనుక ఉంటాయి.
ఎండ్‌పాయింట్‌లకు సంబంధించిన రిఫరెన్స్ ఎక్కడ ఉంది?
API పేజీలో: ప్రమాణీకరణ, ఎండ్పాయింట్లు, రేటు పరిమితి, ఫైల్ ఫార్మాట్‌లు మరియు వెబ్‌హుక్ క్యాటలాగ్ ఉన్నాయి. ఈ పేజీ ఏది మారింది మరియు ఎప్పుడు మారింది అనే వివరాలను మాత్రమే నమోదు చేస్తుంది.
మీరు ఇప్పటికే నడుపుతున్న వాటితో పనిచేస్తుంది
41 కనెక్టర్లు, ఇప్పటికే నిర్మించబడ్డాయి.
ఒప్పందమే ఉత్పత్తి
APIపై నిర్మించండి ఇది మారదు.
API స్టార్టర్ మరియు అంతకంటే ఎక్కువ ప్లాన్‌లలో ఉంది. ఉచితం $0, ప్రారంభంలో 100,000 పదాలు (సైన్-అప్ సమయంలో 25,000, ఫోన్ చెక్ తర్వాత 75,000), తర్వాత నెలకు 10,000, మరియు API లేదా వెబ్‌హుక్‌లు ఉండవు.