개념과 용어

연동의 2단계 구조, 꼭 알아야 할 용어, 로그인 방식 고르는 법을 설명합니다.

구현을 시작하기 전에 알아야 할 개념을 정리했습니다. 이 페이지만 읽어도 전체 구조를 이해할 수 있습니다.

연동은 두 단계입니다

연동(Linking): 회원이 쏠브 앱에서 제휴사 계정으로 로그인하면, 쏠브가 그 회원의 user_key 를 저장합니다. 회원당 한 번만 일어납니다.
동기화(Sync): 쏠브가 user_key 로 구매내역 API 를 호출해, 받은 상품코드에 맞는 책을 책장에 넣거나 뺍니다.

동기화는 쏠브가 필요할 때 제휴사 API 를 호출하는 방식(pull)입니다. 제휴사가 쏠브에 구매 소식을 따로 알려줄 필요는 없습니다.

용어	뜻
`user_key`	제휴사가 정하는 회원 식별자입니다. 한 번 정해지면 바뀌지 않고, 회원끼리 겹치지 않아야 합니다. 내부 회원번호를 권장합니다.
`item_code`	제휴사의 상품코드입니다. 구매내역 API 응답과 쏠브 상품을 잇는 키입니다. 파트너 어드민에서는 연동코드라고 부릅니다.
연동코드	파트너 어드민에서 전자책을 등록할 때 입력하는 값으로, `item_code` 와 같습니다.
시크릿	쏠브가 제휴사 API 를 호출할 때 헤더에 담는 인증 값입니다. 제휴사가 발급해 쏠브에 전달합니다.
`platform_type`	쏠브가 제휴사마다 부여하는 숫자 식별자입니다. ⓑ 방식의 콜백에서만 씁니다.

user_key 로 로그인 아이디나 이메일을 쓰지 마세요

아이디·이메일은 회원이 바꿀 수 있습니다. user_key 가 바뀌면 회원은 연동과 책장의 책을 모두 잃습니다. 탈퇴한 회원의 값을 다른 회원에게 다시 주는 것도 안 됩니다.

소셜로 가입한 회원은 ID/PW 가 없어서 ⓐ 로는 연동할 수 없습니다. 소셜 로그인이 하나라도 있으면 ⓑ 를 고르세요.