시작하기
인증
개발자 센터 대시보드에서 만든 API 키로 공개 API 요청을 인증하는 방법이에요.
API 키#
공개 API 키는 개발자 센터 대시보드에서 만들어요. 키는 esk_live_ 뒤에 영문·숫자 32자가 붙는 형식이고, 만들 때 한 번만 보여요.
키 보내기#
요청마다 API 키를 헤더에 넣어요. 키는 esk_live_ 로 시작하고, 둘 중 편한 헤더를 쓰면 돼요.
http
# Either header works
X-API-Key: esk_live_your_key_here
Authorization: Bearer esk_live_your_key_here키 안전하게 보관하기#
주의
키는 서버에만 두세요. 브라우저·앱 코드에 넣으면 누구나 볼 수 있어요. 유출됐다면 대시보드에서 바로 폐기하고 새로 만드세요. 계정당 활성 키는 최대 5개예요.
파트너 API 키와의 차이#
파트너 포털에서 발급하는 B2B 키(esk_live_<10자>_<40자>)는 형식이 달라 공개 API에 넣으면 거부돼요. 반대도 마찬가지예요. 파트너 API 인증은 파트너 API 인증을 보세요.