개요
이 페이지에서는 Developer Platform 키의 인증, 권한, 만료, 보관 방법을 설명합니다. 키는 하나의 프로젝트에 고정되며 부여된 권한 안에서만 동작합니다.Developer Platform API 키 사용하기
모든 요청에 다음 Authorization 헤더를 보냅니다.필수 권한 설정하기
키 생성 시 용도에 필요한 권한을 선택합니다.
연결 확인용 키와 유료 실행용 키를 나누면 실수로 실행되는 범위를 줄일 수 있습니다. 일반 유료 흐름에 필요한 프로젝트 조회, 견적, 실행, 결과 권한을 모두 점검하세요.
키를 만들 수 있는 역할
프로젝트의ADMIN 또는 DEVELOPER가 키를 만듭니다. 조직 관리자도 해당 프로젝트에 명시적으로 참여해야 접근할 수 있습니다.
키에는 생성자와 프로젝트 권한이 적용됩니다. 생성자 계정이 비활성화되거나 프로젝트에서 제외되거나 키가 폐기되면 사용할 수 없습니다.
만료 관리하기
Developer Platform의 키 생성 화면에서 유효기간을 선택하고, 발급 후 키 목록에서 확인하세요. 전체 키는 한 번만 표시되므로 화면을 닫기 전에 안전하게 저장하세요. 만료 전에 새 키를 만들어 사용처를 전환한 뒤 기존 키를 폐기합니다. 유출이 의심되면 즉시 폐기하세요.키를 안전하게 보관하기
키는 사용자 브라우저로 배포하지 않는 서버 측 비밀 정보로 취급합니다.- 환경 변수나 비밀 정보 관리 서비스에 저장합니다.
- Git, 로그, 오류 화면, 분석 이벤트에 기록하지 않습니다.
- 브라우저나 모바일 앱에 직접 넣지 않습니다.
- 운영, 검증, 개발용 키와 프로젝트를 분리합니다.
- 용도별로 키를 나누고 최소 권한만 부여합니다.
인증 오류 해결하기
HTTP 상태와 키 상태를 차례로 확인합니다.401— Authorization 헤더, 전체 키, 만료, 폐기 여부를 확인합니다.403— 필수 권한과 소유자의 프로젝트 접근 권한을 확인합니다.429— 요청 한도, 선불 잔액, 조직 또는 프로젝트의 월간 한도를 확인합니다.
GET /tools/project로 프로젝트를 조회하세요.