API 토큰¶
개인용 액세스 토큰을 사용하면 스크립트, CI 작업, 또는 어떤 연동이든 여러분 본인으로서 Empi REST API를 호출할 수 있습니다. 여러분이 보는 것과 정확히 동일한 것을 볼 수 있고, 여러분이 바꿀 수 있는 것과 정확히 동일한 것을 바꿀 수 있습니다.
토큰 생성하기¶
- Settings > API를 엽니다.
- Create token을 클릭합니다.
- 나중에 알아볼 수 있도록 Name(예: "CI pipeline")을 입력합니다.
- Permissions를 선택합니다: Read-only(GET 요청만) 또는 Read & write(데이터 읽기 및 수정).
- Expiration(만료 기간)을 선택합니다: 7일, 30일, 90일, 1년, 또는 만료 없음.
- Create를 클릭한 뒤 비밀 값(secret)을 복사합니다.
Warning
비밀 값(secret)은 생성 시점에 한 번만 표시됩니다. 이는 여러분의 워크스페이스 전체에 대한 접근 권한을 부여하므로 비밀번호처럼 보관하고(시크릿 매니저, CI 시크릿 저장소 등), 공유 문서나 공개 저장소에 절대 붙여넣지 마세요. 토큰이 유출되면 즉시 폐기하세요: 폐기는 즉시 적용됩니다.
각 토큰 행에는 만료 시점과 마지막 사용 시점이 표시되므로, 잊고 있던 토큰을 쉽게 찾을 수 있습니다.
토큰 사용하기¶
API 요청에 bearer 토큰으로 전송하세요. 전체 엔드포인트 목록과 파라미터, 응답 형식은 API reference에 있습니다.
토큰 폐기하기¶
토큰 행에서 Revoke를 클릭하고 확인합니다. 토큰은 즉시 작동을 멈추며 복구할 수 없습니다. 이후에도 접근이 필요하다면 새 토큰을 만드세요.
토큰으로 이루어진 호출은 activity log(활동 로그)에 API 호출로 기록됩니다.
Tip
AI 어시스턴트가 여러분의 작업(task)을 다루도록 하는 것이 목표라면 토큰이 전혀 필요하지 않습니다. 대신 MCP server를 사용하세요: 브라우저를 통해 로그인하며, 언제든지 연결을 해제할 수 있습니다.