인증

Narwhal REST 및 MCP 요청에 Bearer 키 하나를 사용하세요.

모든 Narwhal 데이터 요청에는 API 키가 필요합니다. 상태 확인, OpenAPI 및 문서 UI는 계속 공개됩니다.

API 키 받기

Google 또는 GitHub로 계정을 만드세요. 로그인 후 무료 키가 생성되며 한 번만 표시됩니다.

다음 대시보드 페이지에는 로그인한 계정과 설정 링크가 표시됩니다. 전체 키는 여전히 한 번만 표시됩니다.

키를 안전하게 저장하세요

키는 발급될 때 한 번만 반환됩니다. Narwhal은 키 자체가 아닌 단방향 검증 값만 저장하므로 같은 키를 다시 표시할 수 없습니다.

시크릿 관리자 또는 로컬 환경 변수에 보관하세요.
이를 커밋하거나 로그에 붙여 넣거나 URL에 넣지 마세요.
브라우저 측 코드에 노출하지 마세요.

터미널

export NARWHAL_API_KEY="nw_live_..."

요청 인증

키는 HTTP Authorization 헤더에 Bearer 방식으로 보내세요. REST와 MCP는 동일한 헤더를 사용합니다.

인증된 REST 요청

curl --request GET \
  --url https://api.narwhalapi.com/v1/economics/USA/cpi \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

거부된 키 처리

키가 누락되었거나 형식이 잘못되었거나 비활성 상태이거나 알 수 없는 키인 경우 반환하는 상태: 401 코드와 함께 invalid_api_key 및 다음 WWW-Authenticate: Bearer 헤더입니다.

인증이 거부된 요청은 월간 할당량을 소비하지 않습니다. 도움을 요청할 때 사용할 응답 필드: request_id —도움을 요청할 때 사용하세요. 키 자체는 절대 보내지 마세요.

복구 및 교체

로그인한 후 열 페이지: 대시보드 페이지에서 키를 교체하거나 폐기하세요. 교체 시 새 키는 한 번만 표시되며, 새 키를 배포할 수 있도록 기존 키는 24시간 동안 유효합니다. 기존 키는 그 전에 비활성화할 수도 있습니다. 폐기하면 모든 키가 즉시 비활성화됩니다. 24시간 유예 기간은 REST와 MCP에만 적용되며, 이벤트 스트림과 브라우저 스트림 티켓에는 활성 키가 필요합니다. 이전 키를 사용하는 스트림은 약 15초 이내에 종료되고 이전 키로 새로 연결하면 거부되므로, 새 키로 스트림에 다시 연결하세요.

계정 세션에 대한 접근 권한을 잃으면 노출된 키의 사용을 중단하고 Narwhal API 문의 도움말을 위해.

다음으로 계속 진행하세요: 빠른 시작 (키를 안전하게 저장한 후).