테스트와 라이브 모드
키는 프로젝트 단위로 발급됩니다. 프로젝트 모드와 데이터 격리, 라이브 전환 방법을 설명합니다.
API 키는 프로젝트 단위로 발급됩니다. 각 프로젝트는 test 또는 live 모드이고, 키 접두사가 이를 반영합니다(atr_test_… / atr_live_…). 호스트는 하나이며(https://app.atrace.ai/api/v1, AI Engine은 api.atrace.ai), 어떤 키(프로젝트)로 호출하느냐가 모드·데이터·한도를 결정합니다.
| 모드 | 키 접두사 | 개수 | 용도 | 데이터 |
|---|---|---|---|---|
| 테스트 | atr_test_… | 조직당 1개 | 무료로 연동 시험 (소량) | 라이브와 격리 · 실고객 미노출 |
| 라이브 | atr_live_… | 필요한 만큼 | 실서비스 | 실데이터 |
- 테스트 프로젝트는 조직당 1개이며, 작은 용량 안에서 무료로 연동을 검증할 수 있습니다. 실데이터·실트래픽 용도로는 쓰지 마세요.
- 라이브 프로젝트는 실서비스용이며, 리전·플릿 등 필요에 따라 여러 개를 운영할 수 있습니다. 프로젝트마다 자신의 키·데이터·한도를 가집니다.
모드 전환
- 계약(스펙)은 동일합니다. 테스트에서 동작하던 코드는 라이브 키로 바꾸면 그대로 동작합니다(호스트 변경 없음).
- 프로젝트(키)별로 데이터가 격리됩니다. 한 프로젝트에서 만든 리포트는 다른 프로젝트에 나타나지 않으며, 테스트 프로젝트의 리포트는 실고객에게 노출되지 않습니다.
두 API의 모드 동작
- ATRACE Report API는 상태를 저장(stateful)합니다. 키로 만든 리포트·이미지는 해당 프로젝트에만 격리되어 남습니다.
- AI Engine API는 무상태(stateless)입니다. 테스트 키로 호출해도 실제 분석 모델이 그대로 돌아가 동일한 품질의 분석값을 받습니다.
키 관리
- 키는 클라이언트에 노출하지 말고, 노출이 의심되면 즉시 회전(rotate)하세요.
- 프로젝트별 키를 환경 변수로 분리해 관리하세요(예:
ATRACE_API_KEY). - 접두사(
atr_test_/atr_live_)는 모드를 한눈에 알려주는 표시용 라벨일 뿐이고, 실제 모드·데이터는 서버가 프로젝트 레코드로 판별합니다. 테스트 코드에 라이브 키가 섞이지 않도록 확인하세요. - 프로젝트와 키는 콘솔에서 직접 관리합니다. 조직 관리자가 콘솔에 로그인해 프로젝트(test 또는 live)를 만들고, 그 안에서 API 키를 발급합니다. 전체 키는 발급 시 한 번만 표시되니 안전한 곳에 보관하고, 쓰지 않는 키는 콘솔에서 폐기(revoke)할 수 있습니다.