개발자를 위한 transglotAPI, CLI, MCP
문자열 번역하기 대시보드 대신 CI에서.
프랑스어, 독일어, 스페인어로 사이트를 무료로 확인하세요.가입 불필요. 설정 불필요.
스코프된 토큰을 사용하는 REST API, HMAC으로 서명된 12개의 웹훅 이벤트, 에디터가 호출할 수 있는 MCP 서버, 그리고 스키마 재작성 없이 라운드트립이 가능한 20가지 파일 형식을 제공합니다. 파일을 푸시하면 번역된 언어 파일을 받아볼 수 있습니다.
없음
포함
누군가가 기억해서 열어야 하는 대시보드.
CLI와 GitHub Action은 Starter 플랜부터 스코프된 프로젝트 토큰을 사용하여 CI에서 실행됩니다.
중간에 위치한 형식 변환기가 복수형과 주석을 조용히 삭제합니다.
20가지 형식을 네이티브로 읽고 써서 복수형, 플레이스홀더 및 주석이 라운드트립 과정에서 유지됩니다.
실행이 완료되었는지 확인하기 위해 엔드포인트를 폴링해야 합니다.
타임스탬프와 본문에 서명된 12개의 웹훅 이벤트를 제공하므로, 수신자가 자체 재전송 방지 창을 적용할 수 있습니다.
호출 가능한 항목
다섯 가지 진입 경로, 하나의 프로젝트 토큰.
다섯 가지 모두 동일한 범위 지정 토큰으로 인증되며, Free 플랜에서는 이 토큰을 발급할 수 없습니다. Starter 플랜부터 이용 가능합니다.
- cli
transglot push and transglot pull
이미 보유한 파일을 읽고 초안이 작성된 로케일을 다시 파일에 작성합니다. MIT 라이선스가 적용되며 npm에 게시되어 있습니다.
Starter and up - action
GitHub Action
transglot/transglot-action은 푸시(push) 시 초안을 작성하고 로케일을 동일 브랜치에 커밋합니다. MIT 라이선스가 적용되며 저장소는 공개되어 있습니다.
github.com - api
The REST API
토큰당 분당 60회 요청. pull 엔드포인트는 모든 문자열을 가져오는 지원되는 방식입니다.
/api - mcp
The MCP server
에이전트가 17개의 MCP 도구를 직접 호출하며, 그중 4개는 용어집 CRUD 세트입니다.
Starter and up - cdn
The locale bundle on the CDN
Publish a locale JSON bundle and read it from the edge at runtime, rather than shipping a new build for a copy fix.
Starter and up
There is no browser download of translations, deliberately. The ways out are the pull endpoint, the CLI, the CDN bundle and file-storage sync.
FAQs
What a developer checks before writing the first call.
Is there a translation API I can call from my own code?
예: REST API v1, npm용 CLI, GitHub Action, 17개 도구가 포함된 MCP 서버, 12개의 서명된 웹훅 이벤트가 제공됩니다. 이 다섯 가지는 모두 동일한 범위 지정 프로젝트 토큰으로 인증되며, 무료 플랜에서는 토큰을 생성할 수 없으므로 Starter($19/월)부터 시작됩니다.
What does the free plan actually give me?
One project, 100,000 words to start (25,000 at sign-up, 75,000 after a phone check) and 10,000 a month after, three seats, and 15 locale rows including the source, which is 14 target languages. It cannot mint a project token, so the CLI, the Action, the API, webhooks and the MCP server all start at Starter.
How do I put translation in my CI pipeline?
GitHub Action을 추가하세요. 푸시(push) 시 매핑된 모든 언어의 초안을 작성하고 워크플로우가 실행된 브랜치에 커밋합니다. 따라서 기능 브랜치에서는 번역물이 변경 사항과 함께 해당 브랜치의 풀 리퀘스트에 도착하며, 이후에 별도로 처리되지 않습니다. CLI는 다른 러너에서 푸시 및 풀을 수행하며, --wait 옵션을 사용하면 실행 실패 시 종료 코드 0이 아닌 값을 반환하여 단계가 빨간색으로 표시되고 거부된 행이 조용히 통과되는 것을 방지합니다.
What is the API rate limit?
Sixty requests a minute per project token. It is per token rather than per organisation, so a noisy CI job cannot starve your production reader.
How are webhooks signed, and how do I stop replays?
Every delivery carries a timestamp header and an HMAC signature computed over the timestamp and the body. We publish the timestamp so your receiver can enforce whatever replay window it wants; we do not enforce one for you.
Which webhook events do you send?
12 webhook events: batch.completed, batch.failed, key.created, key.updated, key.deleted, translation.updated, translation.reviewed, language.added, language.removed, glossary.updated, qa.completed and source_drift.repaired. The same list is readable at GET /v1/webhooks/events, so your code never has to hardcode it.
What can a project token do, and can I scope it down?
토큰에는 푸시, 풀, 관리, 읽기 및 쓰기라는 다섯 가지 권한이 있으며, 파일 이동만 필요한 작업에는 배포 하위 집합(세 가지 권한)이 있습니다. 토큰은 프로젝트별로 생성되므로, 해당 토큰이 생성되지 않은 프로젝트에는 접근할 수 없습니다.
어떤 파일 형식이 복수형을 지원하나요?
총 20개 중 7개: Android XML, iOS stringsdict, iOS xcstrings, Flutter ARB, gettext PO, CSV 및 XLSX입니다. Laravel PHP는 지원하지 않으며, 고유 형식을 만들지 않고 코덱이 해당 행을 거부합니다.
코딩 에이전트를 위한 MCP 서버가 있나요?
예, 17개의 도구가 제공되므로 에이전트가 편집기를 떠나지 않고도 프로젝트를 읽고, 언어를 목록화 및 추가하며, 단일 번역을 가져오거나 업서트(upsert)하고, 전체 파일을 풀/push하며, 누락된 부분을 번역하고, 배치를 폴링하거나 취소하며, 실패한 배치를 재시도하고 QA를 실행할 수 있습니다. 17개 도구 중 4개는 용어집 도구입니다. 배치 취소 시 사용되지 않은 단어가 할당량으로 반환됩니다.
번역이 검사를 통과하지 못하면 어떻게 되나요?
깨진 플레이스홀더, 누락된 복수형 또는 금지된 용어집 항목은 자동으로 한 번 수정 재시도를 수행하며, 반환된 결과에 대해 검사가 다시 실행됩니다. 여전히 실패하면 행은 파일에 작성되지 않고 거부됩니다. 길이만 초과한 행은 대신 작성되며, Team 플랜부터 자동 승인 또는 QA 실행 시 검토 대상으로 플래그가 지정됩니다.
새 빌드를 배포하지 않고 문자열을 변경할 수 있나요?
웹에서는 가능합니다. 스타터 플랜에서 로케일 번들을 CDN에 게시하고 런타임에 읽어오면, 복사본 수정이 릴리스가 아닌 게시로 처리됩니다. 네이티브 앱은 여전히 파일 형식에서 문자열을 가져오므로 빌드가 필요합니다.
모든 문자열을 어떻게 다시 가져올 수 있나요?
GET /v1/pull, CLI, CDN 번들 또는 S3, Dropbox, Drive로의 파일 저장소 동기화를 사용하세요. 브라우저에서 번역 파일을 다운로드하는 기능은 의도적으로 제공되지 않으므로, 위 네 가지 경로 중 하나를 계획해야 합니다.
오픈 소스로 제공되는 부분이 있나요?
CLI는 MIT 라이선스로 npm에 게시되어 있으며, GitHub Action도 공개 저장소에서 MIT 라이선스로 제공됩니다. 호스팅된 애플리케이션 자체(엔진 및 형식 코덱 포함)는 비공개이며, 이 사이트의 어떤 내용도 그와 반대되는 의미로 해석되어서는 안 됩니다.
이미 운영 중인 서비스와 연동
41개의 커넥터, 이미 구축 완료.
스코프드 토큰 · 서명된 이벤트 · 20개 형식
번역을 CI에 통합하고 더 이상 신경 쓰지 마세요.
무료 플랜은 카드 등록이 필요하지 않습니다. CLI, Action, API 및 MCP 서버는 월 $19의 스타터 플랜부터 시작합니다.