API 키 발급과 관리

Platform 콘솔은 Parallax 를 코드에서 직접 호출하기 위한 개발자용 화면입니다. Parallax 계정으로 로그인해 이용하실 수 있습니다.

키 만들기

1. 콘솔의 API keys 화면을 엽니다.
2. 새 키를 만들고 용도를 알 수 있는 이름을 붙입니다.
3. 생성 직후 화면에 나온 키를 복사해 안전한 곳에 보관합니다.

키 전체 값은 생성 직후 한 번만 보입니다. 화면을 닫으면 다시 확인할 수 없고, 목록에는 어떤 키인지 알아볼 수 있는 일부만 표시됩니다.

안전하게 쓰기

• 키는 서버 환경 변수에 두고 호출하세요. 브라우저에서 쓰는 코드나 모바일 앱에 넣으면 그대로 노출됩니다.
• 저장소(깃 등)에 커밋하지 마세요. 공개 저장소에 올라간 키는 즉시 수집됩니다.
• 용도별, 환경별로 키를 나눠 두면 하나를 폐기해도 나머지가 영향을 받지 않습니다.
• 사람이 바뀌거나 배포 환경이 바뀌면 키를 새로 발급하고 이전 키를 폐기하세요.

키를 잃어버렸거나 노출되었을 때

분실한 키는 복구할 수 없습니다. 콘솔에서 해당 키를 폐기하고 새 키를 발급해 교체해 주세요.

노출이 의심되면 먼저 폐기하고 새 키로 바꾼 뒤, 사용량 화면에서 모르는 호출이 있었는지 확인해 주세요. 확인되지 않는 사용량이 있다면 1:1 문의로 알려 주시면 함께 확인해 드립니다.

호출이 거부될 때

• 인증 오류: 키가 폐기되었거나 헤더에 잘못 전달된 경우입니다. 앞뒤 공백이 섞이지 않았는지도 확인해 주세요.
• 잔액 부족: API 사용에는 선불 잔액이 필요합니다. 사용량과 충전을 참고해 주세요.
• 요청 제한: 짧은 시간에 호출이 몰리면 제한될 수 있습니다. 재시도 간격을 두고 호출해 주세요.