API 키
계정 API 키는 서버를 하나의 계정으로 인증합니다. 앱 API 키는 앱을 설치한 모든 계정에서 앱을 인증합니다. 둘 다 비밀 정보이므로 서버 측에 보관하세요.계정 API 키 생성하기
서버가 내 계정과 그 하위 계정을 대신해 작업할 때 계정 API 키를 사용하세요. 대시보드의 Developer 페이지에서 Account API Keys를 열고 Create를 선택합니다. 빠른 시작에서 샌드박스로 과정을 안내합니다.앱 API 키 생성하기
앱을 빌드하고 앱을 설치한 계정의 데이터에 접근해야 할 때 앱 API 키를 사용하세요.- 대시보드에서 Apps를 엽니다.
- Create app을 선택하고 앱 이름을 지정합니다. 이름은 나중에 변경할 수 있습니다.
- 키는 Environment variables 섹션에서
WHOP_API_KEY뒤에 숨겨진 값입니다. 표시 버튼으로 값을 확인한 다음 안전한 곳에 저장하세요.
계정 범위 사용자 토큰
계정 범위 사용자 토큰은 특정 계정 안에서 특정 사용자 한 명으로 동작합니다. 서버가 API 키로 이 토큰을 발급해 클라이언트에 전달하므로, 사용자는 Whop에 로그인하지 않고도 Whop에 접근할 수 있습니다.POST /api/v1/access_tokens로 생성하며 account_id, user_id, 허용할 작업을 전달합니다:
account_id는 biz_로, user_id는 user_로 시작합니다. API 키에는 둘 다에 접근할 권한이 있어야 합니다.
토큰은 기본적으로 1시간 후에 만료됩니다. expires_at을 설정하면 최대 3시간까지 변경할 수 있습니다. 토큰을 캐시하지 말고 필요할 때마다 발급하세요.
액세스 토큰 생성을 참고하세요.
토큰 범위 지정하기
scoped_actions는 토큰이 할 수 있는 작업의 목록입니다. 각 항목은 콜론으로 구분된 작업 문자열입니다.
작업은 발급하는 자격 증명 자체 권한의 부분집합이어야 합니다. API 키에 없는 권한은 부여할 수 없습니다.
현재 Whop 가이드 전반에 등장하는 작업은 다음과 같습니다:
API는 고정된 목록을 게시하지 않으므로, 이를 전체 목록이 아니라 문서화된 집합으로 취급하세요. 권한의 최종 한계는 항상 발급하는 자격 증명 자체의 권한입니다.
계정 액세스 토큰
계정 액세스 토큰은 사용자 없이 계정 자체로 동작합니다.POST /api/v1/access_tokens에 account_id와 허용할 scoped_actions만 전달하여 생성합니다. 계정 범위 사용자 토큰과 같은 일정으로 만료됩니다.
임베드된 컴포넌트처럼 클라이언트가 짧은 시간 동안 계정의 접근 권한이 필요하고 특정 사용자가 관련되지 않을 때 사용하세요. 알림이나 환경설정 엔드포인트처럼 사용자로 동작하는 엔드포인트는 이 토큰을 거부합니다.
iframe 사용자 토큰
앱이 Whop 안에서 렌더링되면 모든 동일 출처 요청은 x-whop-user-token 헤더에 수명이 짧은 JWT를 담고 있습니다. 서명을 검증해 누가 요청하는지 알아낸 다음, 무엇을 볼 수 있는지 확인하세요. Python과 Ruby SDK는 이를 위한 헬퍼를 제공합니다. TypeScript SDK는 제공하지 않으므로 JWT를 직접 검증하세요.
이 토큰은 직접 발급하지 않습니다. Whop이 전송하고 사용자가 검증합니다. 인증을 참고하세요.
OAuth 토큰
OAuth 토큰은 Whop에 로그인해 일련의 범위에 대해 앱을 승인한 사용자를 나타냅니다. API 키와 달리, 접근 범위는 해당 개별 사용자가 할 수 있는 작업으로 제한됩니다. Whop으로 로그인하기와, 사용자를 대신해 사용자 자신의 계정에서 작업할 때 사용하세요. OAuth를 참고하세요.범위 지정 체크리스트
자격 증명이 프로덕션에 도달하기 전에:- 발급하는 모든 토큰에 명시적인
scoped_actions를 전달하세요. 상속에 절대 의존하지 마세요. - 호출하는 엔드포인트를 파악했다면 API 키를 Admin으로 두지 말고 사용자 지정 권한 집합을 부여하세요.
- API 키는 서버 측에 보관하세요. 클라이언트에는 사용자 토큰만 둘 수 있습니다.
- 수명이 긴 토큰을 캐시하는 대신 수명이 짧은 토큰을 필요할 때 발급하세요.
- 환경마다 별도의 자격 증명을 사용하고, 돈이 오가는 작업을 실행하기 전에 어떤 자격 증명을 사용 중인지 확인하세요.
다음 단계
빠른 시작
샌드박스 키를 만들고 첫 호출을 해 보세요.
핵심 개념
계정, 사용자, 권한이 어떻게 연결되는지 알아봅니다.
OAuth
전체 OAuth 2.1 및 PKCE 흐름.
샌드박스에서 테스트하기
먼저 테스트 데이터로 자격 증명을 시험해 보세요.

