스니핏 API는 API 키로 요청을 인증합니다. 모든 요청의 Authorization 헤더에 API 키를 담아 보내세요.
Authorization: Bearer snp_live_xxxxxxxxxxxxxxxxAPI 키는 개발자 콘솔의 API 키에서 만듭니다. 발급 절차는 빠른 시작을 참고하세요.
API 키는
snp_live_로 시작합니다. 테스트용 키는 별도로 제공하지 않습니다.키 원문은 만들 때 한 번만 표시됩니다. 스니핏은 키 원문을 저장하지 않으므로 다시 보여 드릴 수 없습니다. 키를 잃어버렸다면 API 키에서 키 교체로 새 원문을 받으세요.
API는 서버에서만 호출하세요. 브라우저나 모바일 앱에 포함된 키는 누구나 추출해 사용할 수 있습니다.
키가 유출된 것 같으면 API 키에서 바로 교체하거나 폐기하세요. 교체한 이전 원문과 폐기한 키는 더 이상 사용할 수 없으며, 최대 1분 안에 해당 키로 보낸 모든 요청이 거절됩니다.
API 키로 보낸 요청은 키를 만든 사용자가 보낸 요청으로 처리됩니다. 해당 사용자가 스니핏에서 볼 수 없거나 할 수 없는 일은 API로도 할 수 없습니다. 사용 금액은 워크스페이스 잔액에서 차감됩니다.
키를 만든 사용자의 역할이 바뀌면 키의 권한도 함께 바뀝니다. 해당 사용자가 워크스페이스를 떠나면 키로 보낸 요청은 403 AUTH_FORBIDDEN으로 거절되니, 남은 소유자나 관리자가 새 키를 만들어 교체하세요.
오류 | 원인 | 해결 방법 |
|---|---|---|
|
|
|
| 교체했거나 폐기한 키를 사용함 | 새 키 원문으로 바꾸세요. |
| 워크스페이스 요금제가 Scale이 아님 | Scale 플랜으로 변경하세요. |
| 키를 만든 사용자가 이 워크스페이스에 접근할 수 없음 | 소유자나 관리자가 새 키를 만들어 교체하세요. |
역할 | 할 수 있는 일 |
|---|---|
소유자·관리자 | 팀원 권한 전체, API 키 만들기·이름 변경·교체·폐기, 결제 수단 등록과 충전 |
팀원 | 사용량·요청 로그 보기 |