SNIPIT 도움말

스니핏 API는 API 키로 요청을 인증합니다. 모든 요청의 Authorization 헤더에 API 키를 담아 보내세요.

Plaintext
Authorization: Bearer snp_live_xxxxxxxxxxxxxxxx

API 키는 개발자 콘솔의 API 키에서 만듭니다. 발급 절차는 빠른 시작을 참고하세요.

  • API 키는 snp_live_로 시작합니다. 테스트용 키는 별도로 제공하지 않습니다.

  • 키 원문은 만들 때 한 번만 표시됩니다. 스니핏은 키 원문을 저장하지 않으므로 다시 보여 드릴 수 없습니다. 키를 잃어버렸다면 API 키에서 키 교체로 새 원문을 받으세요.

  • API는 서버에서만 호출하세요. 브라우저나 모바일 앱에 포함된 키는 누구나 추출해 사용할 수 있습니다.

  • 키가 유출된 것 같으면 API 키에서 바로 교체하거나 폐기하세요. 교체한 이전 원문과 폐기한 키는 더 이상 사용할 수 없으며, 최대 1분 안에 해당 키로 보낸 모든 요청이 거절됩니다.

API 키로 보낸 요청은 키를 만든 사용자가 보낸 요청으로 처리됩니다. 해당 사용자가 스니핏에서 볼 수 없거나 할 수 없는 일은 API로도 할 수 없습니다. 사용 금액은 워크스페이스 잔액에서 차감됩니다.

키를 만든 사용자의 역할이 바뀌면 키의 권한도 함께 바뀝니다. 해당 사용자가 워크스페이스를 떠나면 키로 보낸 요청은 403 AUTH_FORBIDDEN으로 거절되니, 남은 소유자나 관리자가 새 키를 만들어 교체하세요.

오류

원인

해결 방법

401 AUTH_UNAUTHORIZED

Authorization 헤더가 없거나 형식이 잘못됨

Authorization: Bearer <API 키> 형식인지 확인하세요.

401 AUTH_UNAUTHORIZED

교체했거나 폐기한 키를 사용함

새 키 원문으로 바꾸세요.

403 PUBLIC_API_PLAN_REQUIRED

워크스페이스 요금제가 Scale이 아님

Scale 플랜으로 변경하세요.

403 AUTH_FORBIDDEN

키를 만든 사용자가 이 워크스페이스에 접근할 수 없음

소유자나 관리자가 새 키를 만들어 교체하세요.

역할

할 수 있는 일

소유자·관리자

팀원 권한 전체, API 키 만들기·이름 변경·교체·폐기, 결제 수단 등록과 충전

팀원

사용량·요청 로그 보기