인증

API 키 받기

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

다음 대시보드 로그인한 계정과 설정 링크를 보여줍니다. 완전한 키는 여전히 한 번만 표시됩니다.

키를 안전하게 저장하세요

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

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

export NARWHAL_API_KEY="nw_live_..."

요청 인증

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

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 도움을 요청할 때 사용하며 키 자체는 절대 보내지 마세요.

복구 및 교체

로그인하고 다음을 여세요 대시보드 활성 키를 교체하거나 취소하기 위해. 교체 또는 취소하면 기존 키가 즉시 중지되며 새 키는 한 번 표시되고 나중에 복구할 수 없습니다.

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

다음으로 계속 빠른 시작 키를 안전하게 저장한 후입니다.