API Key 발급
대시보드에서 API Key를 발급·연장·재발급·회수하는 방법을 안내합니다.
발급 절차
구분설명
① 경로
대시보드 > API 연동설정 > API 키발급
② 발급
「발급」 버튼 클릭 후 표시되는 전체 Secret Key를 안전한 곳에 저장합니다.
③ 형식
운영 키 prefix는 qnc_live_ 입니다. Bearer 토큰으로 전달합니다.
④ 유효기간
발급일 기준 1년. 만료 30일 전부터 expiring_soon 상태로 표시됩니다.
키 생명주기
구분설명
연장
만료 전 키의 유효기간을 1년 연장합니다. Secret은 변경되지 않습니다.
재발급
새 Secret이 발급되고 구 키는 즉시 회수됩니다. 연동 중인 시스템의 키를 바로 교체해야 합니다.
회수
즉시 API 호출이 차단됩니다. 되돌릴 수 없으며 필요 시 새로 발급합니다.
보안 수칙
- API Key는 서버 환경 변수에만 보관하고, 클라이언트(브라우저·모바일 앱)에 노출하지 마세요.
- Git 저장소·로그·채팅에 키를 올리지 마세요. 유출 시 즉시 회수 후 재발급하세요.
- 판매자당 활성 API Key는 1개입니다. 새 키가 필요하면 재발급하거나 회수 후 다시 발급하세요.