https://api.whop.com/api/v1의 Current API로 이전됩니다.
Current API로 전환하기
1
API 키 유지하기
Current API는 동일한 계정 및 앱 API 키를 사용합니다. 요청이
403을 반환하면 해당 엔드포인트에 필요한 권한이 키에 없는 것입니다. Developer → API keys에서 권한을 추가하거나 앱의 권한에서 요청하세요.2
SDK 설치 및 버전 고정하기
공식 SDK는 Current API를 호출하며 빌드 기준이 된 API 버전을 전송합니다. SDK 없이 API를 호출한다면 모든 요청에
@whop/api를 사용한다면 @whop/sdk로 교체하세요. withUser 및 withCompany 헬퍼에는 대응하는 기능이 없습니다. 대신 각 요청마다 사용자 또는 계정 ID를 전달하세요.Api-Version-Date를 전송하세요. API 버전에서 버전 고정을 설명합니다.3
각 호출 교체하기
이전하려는 API의 탭을 사용한 다음, 코드에서 이전 기본 URL이나 패키지를 제거하세요.
- API v2
- 공개 GraphQL
v2 호출 찾기
모든 v2 응답에는 세 가지 헤더가 포함됩니다:Deprecation이 포함된 응답을 기록하여 연동에서 아직 수행하는 모든 v2 호출을 찾으세요.경로 매핑
멤버십 및 라이선스
멤버 및 고객
결제 및 체크아웃
상품 및 플랜
플랜은 이제 변형(variant)이라고 부릅니다. 변형 ID는plan_ 접두사를 유지하므로 저장된 ID는 계속 작동합니다.계정, 경험, 리뷰, 웹훅
v2에서 변경된 사항
부분 업데이트
v2는POST /resource/{id}로 리소스를 업데이트했습니다. Current API는 PATCH /resource/{id}를 사용하며 전송한 필드만 변경합니다.라이선스 키
v2의validate_license는 한 번의 호출로 키를 확인하고 기기에 연결했습니다. Current API에서는 서버가 라이선스 키로 멤버십을 조회하고, status를 확인하며, 누군가 키를 처음 사용할 때 하드웨어 ID를 metadata에 기록합니다. SaaS 가이드에 전체 예시가 있습니다.이 호출은 서버에서 수행하세요. 계정 API 키는 비즈니스의 모든 멤버십을 변경할 수 있으므로 다운로드 가능한 소프트웨어에 절대 포함하지 마세요.v2 형식의 웹훅
v2를 통해 생성된 웹훅은 계속 v2 형식의 페이로드를 전송합니다. 현재 형식을 받으려면 대시보드에서 또는POST /webhooks로 새 웹훅을 생성하고, 핸들러를 새 웹훅으로 옮긴 다음 v2 웹훅을 삭제하세요. 웹훅에서 서명 확인과 이벤트 유형을 다룹니다.페이지네이션
v2는page와 per로 페이지를 나누고 pagination.current_page와 pagination.total_page를 반환했습니다. Current API 목록은 data 배열과 page_info 객체를 반환합니다. 페이지 크기를 설정하려면 first를 전달하고, 다음 페이지를 가져오려면 이전 page_info.end_cursor와 함께 after를 전달하세요. page_info.has_next_page가 false이면 중단하세요. SDK는 페이지 처리를 자동으로 해줍니다.
다음 단계
API 버전
버전을 고정하여 이후 변경 사항이 연동을 손상시키지 않도록 하세요.
웹훅
서명을 확인하고, 현재 이벤트 형식을 처리하며, 폴링 대신 채팅 메시지를 수신하세요.
멤버십 관리
멤버십을 취소, 일시 중지, 연장, 업데이트하세요.
앱 뷰
경험 및 대시보드 뷰에서 멤버 액세스를 확인하세요.

