api.transglot.ai/v1Bearer 토큰, 단일 프로젝트참조 문서

파일 업로드. 모든 언어 번역 완료.

앱 번역을 위한 REST API입니다. 소스 파일을 업로드하려면 POST 요청 한 번, 완성된 로케일을 받아오려면 GET 요청 한 번이면 충분하며 인증은 Bearer 토큰 하나로 처리됩니다. HTTP를 지원하는 어떤 환경에서도 사용할 수 있습니다.

입력: 호출 1회

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

Starter 플랜에서 월간 단어 수, 토큰을 생성할 수 있는 첫 번째 플랜입니다.

무료로 시작하기 개발자용 인터페이스 보기

토큰당 분당 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

AI 에이전트에게 귀하가 가진 것과 동일한 17가지 도구를 제공하세요.

분당 요청 수

계정별이 아닌 토큰별이며, 모든 429 응답에는 대기해야 할 초수를 나타내는 Retry-After 헤더가 포함됩니다.

파일 형식

저장소에서 이미 사용하는 형식을 푸시하고 가져옵니다. 복수형과 플레이스홀더는 양방향으로 모두 유지됩니다. 호출 시 format=을 사용하여 이름을 지정하세요.

웹훅 이벤트

전체 카탈로그를 제공하며, 각각 실제 전달 시와 동일한 구조의 예제 페이로드를 포함합니다. GET /v1/webhooks/events.

MCP 도구

curl 대신 에이전트 런타임에 전달되는 동일한 프로젝트 토큰입니다. npx -y @transglot/mcp.

자주 묻는 질문

첫 번째 요청 전에 개발자들이 묻는 질문들입니다.

Transglot API 인증은 어떻게 하나요?

Bearer 토큰을 전송하세요: Authorization: Bearer $TRANSGLOT_TOKEN. 토큰은 하나의 프로젝트에 속하므로 경로에 프로젝트 ID가 없으며 계정 전체 키가 유출될 위험도 없습니다. 프로젝트 페이지에서 토큰을 생성할 수 있으며 각 토큰에는 푸시, 풀, 관리, 읽기, 쓰기 등 고유한 권한이 부여됩니다.

API는 무료인가요?

아니요. Bearer 토큰은 월 $19의 Starter 플랜부터 시작됩니다. 무료 버전은 콘솔 사용을 포함하며 제품이 적합한지 확인하기에 충분하지만 토큰을 발급할 수는 없습니다. CLI, GitHub Action, 웹훅, MCP 및 배송 번들은 모두 동일한 토큰 뒤에 있으므로 함께 제공됩니다.

Transglot에 문자열을 업로드하려면 어떻게 해야 하나요?

파일과 형식을 포함하여 POST /v1/push를 사용하세요. 예를 들어 -F "file=@lang/en.json" -F "format=laravel_json"입니다. 202 응답을 받고 배치가 큐에 추가됩니다. 실제로 변경된 행만 번역되므로 변경되지 않은 파일을 푸시해도 비용이 발생하지 않습니다.

번역 결과를 다시 가져오려면 어떻게 해야 하나요?

언제든지 원하는 형식(총 20가지)으로 GET /v1/pull을 사용하세요. 이는 CLI가 래핑하는 엔드포인트이며 API 플레이그라운드에서 실시간으로 실행되는 엔드포인트입니다. 별도의 내보내기 요청이나 데이터 소유권이 중단되는 기간이 없습니다.

What is the API rate limit?

60 requests a minute, counted per token rather than per account. Over it you get a 429 with a Retry-After header saying how many seconds to wait, and nothing is charged or half written. Give CI and production separate tokens and a noisy build cannot starve your app.

API는 어떤 언어를 지원하나요?

고정된 목록은 없습니다. 검증기는 ICU가 인식하는 모든 BCP-47 태그를 허용하며, 이는 검사 대상 테이블의 708개 로케일과 그 외 태그에 대한 구조적 폴백을 포함합니다. 프로젝트에 로케일을 추가하면 다음 푸시 시 포함됩니다.

푸시 및 풀할 수 있는 파일 형식은 무엇인가요?

20가지 형식: 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. 이 중 7가지 형식은 복수형을 지원하며, 파일은 입력된 형태 그대로 반환됩니다.

Transglot에 웹훅이 있나요?

예. batch.completed, translation.reviewed, qa.completed, source_drift.repaired 등을 포함한 12개의 웹훅 이벤트가 있습니다. 모든 전달은 타임스탬프 헤더와 함께 HMAC 서명되어 검증할 수 있으며, GET /v1/webhooks/events는 각 이벤트에 대한 샘플 페이로드가 포함된 카탈로그를 반환합니다.

AI 에이전트를 위한 MCP 서버가 있나요?

예. npx -y @transglot/mcp는 프로젝트 토큰을 통해 17가지 도구를 노출하므로, 어시스턴트가 번역을 읽거나 작성하고, 언어를 추가하며, 실행을 시작하거나 배치를 확인하고 용어집을 편집할 수 있습니다. 이는 curl 대신 에이전트 런타임에서 접근하는 동일한 API와 동일한 권한입니다.

CI에서 실행할 수 있나요?

예. GitHub Action(transglot/transglot-action@v1)과 CLI 모두 이러한 엔드포인트를 래핑합니다. 행이 거부되면 transglot push --wait는 종료 코드 4로 끝나고 해당 실행에서 Action의 작업이 실패합니다. 병합을 중지하려면 커밋 입력을 none으로 설정한 상태에서 풀 리퀘스트에 대해 실행하고, 가져온 파일에 키가 누락된 경우 실패하는 단계를 추가한 뒤, 브랜치 보호 규칙에서 이 작업을 필수 검사로 설정하세요.

번역이 품질 검사를 통과하지 못하면 어떻게 되나요?

네 가지 결정론적 게이트가 모든 행을 검사합니다: 자리 표시자, 복수형, 용어집 항목 및 길이. 잘못된 자리 표시자, 누락된 복수형 또는 금지된 용어집 항목은 자동으로 한 번 수정 재시도를 거치며, 그래도 실패하면 행은 기록되지 않고 거부됩니다. 길이 제한만 초과한 행은 거부되지 않고 기록됩니다. GET /v1/batches/:id?include=failures는 거부된 행과 그 이유를 나열합니다.

API가 내 통합 환경을 중단시킬 수 있나요?

아니요. /v1은 엔드포인트와 응답 필드만 계속 추가되며, 이미 파싱 중인 필드의 구조가 변경되거나 사라지지 않습니다. 호환성이 깨지는 변경 사항은 새로운 버전 접두어 아래에 배포되며, 이 접두어는 예약되어 있고 현재 비어 있습니다. API 변경 로그에는 모든 릴리스가 기록됩니다.