API 키

키 생성 및 폐기섹션 링크 복사

NinjaBuy에 로그인한 후 계정 → 친구 초대 → API 키에서 이름이 있는 키를 생성하고, 목록을 확인하고, 폐기하세요. 전체 키는 nb_로 시작하며 한 번만 표시됩니다. 메시지를 닫기 전에 키 복사로 안전하게 보관하세요.

키는 만들 때 유효 기간(30일, 90일, 1년)을 고르지 않는 한 만료되지 않습니다. 폐기나 유효 기간 종료는 다음 요청부터 적용되며, 만료된 키는 목록에서 사라집니다.

키의 SHA-256 해시만 저장됩니다.

키 사용섹션 링크 복사

키를 스크립트에 NINJABUY_API_KEY로 전달하고 Authorization 헤더에 포함하세요.

curl -sS https://www.ninjabuy.com/api/v1/links \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"links":["https://weidian.com/item.html?itemID=7581746714"]}'

같은 헤더를 인증이 필요한 모든 REST 경로에서 사용할 수 있습니다. 링크, 검색, 업로드 및 시트, 작업이 해당됩니다. OpenAPI 문서에는 인증이 필요하지 않습니다.

권한 및 제한섹션 링크 복사

모든 키에 세 가지 권한이 모두 부여됩니다. 범위 선택 기능은 없습니다.

키와 OAuth REST 요청은 계정의 생성 및 검색 제한을 공유합니다. MCP 링크 생성도 생성 제한을 공유합니다. 요청 제한을 확인하세요.

키로는 로그인하거나 세션을 열거나 MCP 또는 계정 API를 호출할 수 없습니다. 다른 NinjaBuy 고객을 대신하여 작동하는 애플리케이션이나 MCP 클라이언트에는 OAuth를 사용하세요.

오류섹션 링크 복사

유효하지 않거나 만료되었거나 폐기된 키는 유효하지 않은 OAuth 토큰과 동일한 401 문제 응답을 반환합니다. 키 저장소 장애 시 Retry-After와 함께 503이 반환됩니다. 오류를 확인하세요.