인증

ArchiCore는 인증을 위해 API 키를 사용합니다.

API 키 받기

1. ArchiCore에 로그인
2. 설정 → 개발자로 이동
3. API 키 생성 클릭
4. 키를 복사하여 안전하게 보관

경고

API 키는 한 번만 표시됩니다. 안전하게 보관하세요!

API 키 사용

Authorization 헤더에 키를 포함:

curl -H "Authorization: Bearer sk_live_xxxxx" \
  https://api.archicore.io/api/v1/projects

또는 쿼리 파라미터로 (권장하지 않음):

curl "https://api.archicore.io/api/v1/projects?api_key=sk_live_xxxxx"

키 유형

접두사	유형	설명
sk_live_	프로덕션	계정에 대한 전체 액세스
sk_test_	테스트	개발용 제한된 액세스

키 권한

API 키는 계정 티어의 권한을 상속합니다:

권한	무료	Pro	Enterprise
프로젝트 읽기	✓	✓	✓
프로젝트 생성	✓	✓	✓
분석	✓	✓	✓
Webhooks	-	✓	✓
팀 액세스	-	-	✓

키 취소

API 키를 취소하려면:

1. 설정 → 개발자로 이동
2. 목록에서 키 찾기
3. 취소 클릭

취소된 키는 즉시 작동을 중지합니다.

보안 모범 사례

1. API 키를 커밋하지 마세요 버전 관리에
2. 환경 변수 사용 키 저장에
3. 정기적으로 키 교체 (권장: 90일마다)
4. 개발에는 테스트 키 사용
5. 대시보드에서 사용량 모니터링

환경 변수

# .env (.gitignore에 추가!)
ARCHICORE_API_KEY=sk_live_xxxxx

const client = new ArchiCore({
  apiKey: process.env.ARCHICORE_API_KEY
});

OAuth (출시 예정)

OAuth 2.0 지원은 팀 통합을 위해 계획 중입니다.