구현 순서

로그인 방식 고르기

회원 인증 방식에 따라 하나를 고릅니다. 기준은 개념과 용어에 있습니다.

ⓑ 를 고르면 쏠브가 콜백 API URL, platform_type 값, 콜백 인증 시크릿을 전달해 드립니다.

로그인 구현하기

로그인에 성공하면 회원의 불변 식별자(user_key)를 쏠브에 넘겨줍니다. 로그인 아이디나 이메일처럼 바뀔 수 있는 값이 아니라, 내부 회원번호처럼 절대 바뀌지 않는 값을 쓰세요.

• ⓐ: 쏠브가 보낸 ID/PW 를 검증하고 { "user_key": "..." } 로 응답합니다.
• ⓑ: 제휴사 페이지에서 로그인시킨 뒤, 서버에서 쏠브 콜백을 호출하고 받은 redirect_url 로 이동시킵니다.

구매내역 API 구현하기

쏠브가 user_key 를 보내면 지금 이용할 수 있는 상품코드 목록을 돌려줍니다. 상세는 구매내역 API를 보세요.

{
  "item_list": [
    { "item_code": "BOOK_TOEIC_2026", "item_name": "토익 실전 2026" }
  ]
}

• 환불·만료된 상품은 목록에서 빼주세요. 쏠브 책장에서도 빠집니다.
• 회원이 없으면 오류가 아니라 빈 목록(200) 으로 응답해 주세요.

전자책 등록하기 (연동코드 입력)

쏠브 파트너 어드민에서 전자책 PDF 를 등록할 때 판매유형을 연동형 또는 연동+쏠브북스로 고르고, 연동코드란에 구매내역 API 가 돌려주는 item_code 와 같은 값을 입력합니다. 그러면 그 상품을 구매한 회원의 책장에 책이 자동으로 들어갑니다. 상세는 상품 연결을 보세요.

셀프 점검 후 테스트 자료 전달하기

테스트와 출시의 셀프 점검 스크립트로 먼저 확인한 뒤, 아래 자료를 쏠브에 보내주세요. 구매내역 API 와 ⓐ 로그인 API 는 전체 점검 도구(solve-selfcheck.mjs)로, ⓑ 방식의 콜백은 콜백 흉내 도구로 미리 시험할 수 있습니다. 쏠브가 실제 호출과 앱 화면으로 검증하고 출시 일정을 잡습니다.

• 로그인 URL(ⓐ API 또는 ⓑ 로그인 페이지)과 구매내역 API URL
• 구매 내역이 있는 테스트 계정
• 그 계정이 보유한 item_code 와 상품명