제휴사 연동
개요와 용어
2단계 연동 모델과 로그인 방식 선택 기준
개요와 용어
연동은 연동(회원 확인) 과 동기화(콘텐츠 권한 설정) 두 단계로 진행됩니다. 본격적으로 시작하기 전에, 자주 쓰는 용어와 로그인 방식 선택 기준을 먼저 확인해 주세요.
용어
user_key— 제휴사가 발급하는 회원 식별자입니다. 한 번 연동되면 영원히 바뀌지 않아야 하고, 회원 간에 겹치지 않아야 합니다.item_code— 제휴사의 상품·강의 코드입니다. 구매내역과 상품 카탈로그를 연결하는 키로 사용됩니다.- 연동(Linking) — 쏠브 사용자와 제휴사 회원을
user_key로 묶어주는 단계입니다. - 동기화(Sync) —
user_key로 구매내역을 받아와, 쏠브 안에서 이용 권한을 부여하거나 회수하는 단계입니다.
2단계 모델
- 연동 — 제휴사 로그인을 거쳐
user_key를 받아오면, 쏠브가 이 값을 저장합니다. - 동기화 — 쏠브가
user_key로 구매내역 API를 호출해서 상품 카탈로그와 맞춰보고, 이용 권한을 부여합니다. 사용자가 책장에 들어가거나 "전체 동기화"를 누를 때 진행됩니다 (pull 방식).
로그인 방식 선택
- 자체 ID/PW를 검증하는 서버 API를 만들 수 있다면 ⓐ 자격증명 API 를 권장합니다. 통합이 더 단순합니다.
- 카카오·구글 같은 소셜 로그인을 쓰거나, 자체 로그인 페이지만 운영한다면 ⓑ 호스팅 로그인 페이지 를 사용합니다.
누가 무엇을 정하나요?
| 쏠브가 정합니다 | 제휴사가 정합니다 |
|---|---|
user_key 는 불변·유일이어야 한다는 규칙 | 로그인 방식 (ⓐ 또는 ⓑ) |
구매내역 응답 스키마 (item_list[].item_code) | API 엔드포인트 URL |
ⓑ 콜백 규약 (id·platform_type) | 인증 헤더 스킴 |
| "현재 유효한 권한만 반환한다"는 규칙 | 제휴사 내부 데이터 구조 |