api v1 · 현재
API 변경 로그.
삭제된 항목 없음.
/v1은 항목만 계속 추가됩니다. 새로운 엔드포인트와 응답 필드는 동일한 접두어 내에 추가되며, 이미 파싱 중인 필드는 구조가 변경되거나 사라지지 않습니다. 호환성이 깨지는 변경 사항은 새로운 버전 접두어 아래에 배포되며, 이 접두어는 예약되어 있고 현재 비어 있습니다.
v1/api/v1
유일하게 사용 중인 접두어
유일하게 사용 중인 접두어
5개 릴리스
11개 변경 사항, 호환성 파괴 없음
로그의 형태
하나의 버전 접두어, 삭제 없음.
이 네 가지 중 세 가지는 이 로그 자체의 속성입니다. 나머지 하나는 API가 제공하는 웹훅 카탈로그의 규모입니다.
5
/v1의 릴리스, 모두 추가적인 변경 사항
1
사용 중인 버전 접두어. 다음 접두어는 예약되어 있으며 비어 있음
0
API 출시 이후의 호환성 파괴 변경 사항
12
서명된 웹훅 이벤트. 출처: App\Enums\WebhookEvent
semver가 아닌 릴리스 날짜 기준
화살표 키를 사용하여 이동
2026-07-08
CDN 전달, 사용량 및 플레이그라운드
July 8, 2026 · 4개의 변경 사항
05 / 05
added
배포 키 모델로, 베어러 토큰이 곧 프로젝트입니다. CLI와 GitHub Action 모두 이 모델을 기반으로 실행됩니다.
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에 있으며, 현재 12개의 케이스를 포함합니다; 이 줄 대신 enum을 확인하세요.
서명된 웹훅은 원래 배치 쌍과 함께 키, 번역, 언어, 용어집 및 QA 이벤트를 발행합니다.
improved
전달에는 변경된 행마다 한 번의 호출 대신 카운트와 최대 20개의 샘플이 포함됩니다. 전달 로그는 다음 재시도 시간과 함께 모든 시도를 기록합니다.
translation.updated와 같은 고빈도 이벤트는 하나의 전달 윈도우로 통합되므로 대량 편집이 엔드포인트를 과부하시키지 않습니다.
added
ETag와 단기 캐시를 반환하며 If-None-Match를 준수하여 304를 응답합니다. /v{n} 아래의 불변 형제는 콘텐츠 주소 지정되며 1년간 캐시됩니다.
공개적이고 엣지 캐시 가능한 GET /v1/cdn/{project}/{locale}은 게시된 문자열을 제공합니다.
added
CI에서 POST /v1/cdn/publish로 트리거하고, X-Transglot-Cdn-Key 헤더의 전용 읽기 전용 키로 읽기를 승인하세요. 자체 CDN 뒤에 배치해도 안전합니다.
게시는 현재 번역을 새 불변 버전으로 승격시키며, 수동으로 또는 모든 푸시 시 수행됩니다.
added
요청 본문은 저장되지 않습니다. 단순히 카운트만 기록됩니다.
Every authenticated /v1 call is counted per token per day, and surfaced on the deploy hub.
improved
프로젝트, 풀, 배치 및 용어집 내보내기 기능을 지원합니다. 이를 위해 요청 또는 응답 형식이 변경되지는 않았습니다.
배포 허브에 프로젝트의 읽기 전용 엔드포인트를 실시간으로 실행할 수 있는 API 플레이그라운드가 추가되었습니다.
사용 중단 등록부
아무것도 사라집니다.
게시된 각 표면(surface)당 한 행씩 표시되며, 해당 기능이 포함된 릴리스가 함께 표시됩니다. 마지막 열을 주의 깊게 살펴보세요: 제거 예정일자는 실제 제거 발생 훨씬 전에 여기에 날짜와 함께 표시됩니다.
| 표면 | 배포됨 | 상태 | 제거 일자 |
|---|---|---|---|
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 | 현재 | 예정 없음 |
이 테이블에서 행이 삭제되는 경우는 없습니다. 표면(surface)이 퇴출되더라도 행은 유지되며 날짜가 추가됩니다. 계획 가능한 제거 일자를 제공하는 것이 공개의 주요 목적이기 때문입니다.
호환성 약속
세 가지 규칙 기반으로 구축할 수 있습니다.
추가적
새로운 엔드포인트와 응답 필드는 /v1 내에서 제공됩니다. 이미 파싱 중인 필드는 형태가 변경되지 않으며 사라지지 않습니다.
새로운 접두사
중단적 변경은 기존 버전 내부가 아닌 새로운 버전 접두사 하에 제공됩니다. 해당 접두사는 예약되어 있으며 현재 사용되지 않고, v1 이상의 모든 릴리스는 v1에 포함되었습니다.
정직한 헤더
풀(pull) 요청에서 무언가를 왕복 처리할 수 없는 경우 헤더에 이를 명시합니다. 본문 내용을 변경하는 대신 X-Skipped-Keys 및 X-Missing-Source-Keys가 추가되었습니다.
자주 묻는 질문
개발자가 API 버전 관리 및 지원 중단에 대해 묻는 사항입니다.
Transglot API는 버전이 관리되나요?
예, URL 접두사를 통해 관리됩니다. 현재까지 게시된 모든 내용은 /v1 하위에 있으며, 이는 유일하게 사용되는 접두사입니다. 버전 헤더, 날짜 고정 또는 구성해야 할 항목은 없습니다.
업데이트로 인해 내 통합 작업이 중단될 수 있나요?
/v1 내부에서는 그렇지 않습니다. 새로운 엔드포인트와 응답 필드가 추가되지만, 이미 파싱 중인 필드는 형태가 변경되지 않으며 사라지지 않습니다. 만약 추가적으로 적용할 수 없는 변경 사항이 발생하면 새로운 접두사 하에 제공되며, 기존 접두사는 계속 작동합니다.
지원 중단되거나 제거된 항목이 있나요?
없으며, 위의 레지스터가 행별로 이를 나타냅니다. 게시된 모든 표면은 제공된 릴리스와 함께 나열되며, 제거 열에는 현재 전체적으로 "예정 없음"이라고 표시됩니다.
제거 시 얼마나 미리 공지하나요?
삭제 항목은 실제 발생 시점보다 훨씬 이전의 날짜로 해당 레지스터에 표시되며, 행은 사라지지 않고 테이블에 그대로 남습니다. 계획 수립에 활용할 수 있는 날짜를 제공하는 것이 바로 이 정보를 공개하는 핵심 목적입니다.
새로운 기능이 출시되는 시점은 어떻게 알 수 있나요?
모든 릴리스는 이 페이지에 날짜와 함께 기록됩니다. 제품 변경 로그에는 출시되는 다른 모든 사항이 포함되며, 콘솔에서는 아직 읽지 않은 항목이 있을 때 마커가 표시됩니다.
API용 변경 로그가 별도로 존재하는 이유는 무엇인가요?
API는 제품 릴리스와는 달리 호환성 보장을 제공하기 때문입니다. 개발자가 통합 기능이 여전히 작동하는지 확인하려면 기능 업데이트 내용을 스크롤하여 넘기지 않고도 쉽게 확인할 수 있어야 합니다.
내 플랜에 API를 추가하려면 어떻게 해야 하나요?
Bearer 토큰은 월 $19의 Starter 플랜부터 시작됩니다. Free 플랜은 콘솔 사용은 가능하지만 토큰을 발급할 수 없으며, CLI, GitHub Action, 웹훅 및 MCP는 모두 동일한 토큰 뒤에 위치합니다.
엔드포인트 자체에 대한 참조 자료는 어디에 있나요?
API 페이지에 있습니다: 인증, 엔드포인트, 속도 제한, 파일 형식 및 웹훅 카탈로그. 이 페이지는 변경된 내용과 시점만을 기록한 것입니다.
이미 운영 중인 서비스와 연동