- 인쇄
shoplive.show
- 인쇄
이 페이지는 샵라이브에서 제공하는 shoplive.show 도메인 기반의 플레이어 페이지를 고객사의 웹사이트 / 모바일 애플리케이션(Web view)에 연동하기 위한 가이드를 제공합니다.
JavaScript SDK를 통한 설치와 샵라이브 플러그인을 통한 설치는 고객사에서 서비스하는 랜딩 페이지가 있어야만 플레이어를 설치할 수 있는데 반해, shoplive.show 페이지를 통해 제공하는 플레이어는 고객사에 별도의 랜딩 페이지가 없이 간단한 URL 호출만으로 플레이어를 실행할 수 있습니다.
shoplive.show에서 제공하는 플레이어 호출을 위한 URL과 파라미터는 아래 내용을 참고하시기 바랍니다.
Player URL
URL 파라미터
Parameter name | Description |
---|---|
(필수) | 고객사의 access key 정보 |
(필수) | 플레이어에서 재생할 campaign key 정보 |
| 일반 인증 또는 JWT 토큰 형태의 인증 정보 (게스트 사용자의 경우 |
| 1(표시) | 0(표시하지 않음) |
| 1(표시) | 0(표시하지 않음) |
인증 정보 설정(tk
파라미터)
간편 인증 (자세히 보기)
JSON 객체로 userId, userName 등의 정보를 설정한 후 tk
파라미터로 플레이어를 호출할 때 반드시 url encode하여 전달하여야 합니다.
간편 인증 예시
JSON 객체
{
userId
: "USER_ID",userName
: "USER_NAME"}
tk
파라미터에서 사용할 url encode된 JSON 객체%7B%22userId%22%3A%20%22userID%22%2C%20%22userName%22%3A%22userName%22%7D
URL Encode가 두 번 되지 않도록 주의하세요.
JWT 인증 (자세히 보기)
고객사 서버에서 secret key로 암호화하여 JWT를 생성한 후 생성된 토큰을 tk
파라미터로 전달합니다.
URL 형태별 예시
Format | Example |
---|---|
기본 | https://www.shoplive.show/v1/player.html?ak={access_key}&tk={JWT_token}&ck={campaign_key} |
Guest 사용자를 위한 플레이어를 호출 ( 파라미터를 전달하지 않음) | https://www.shoplive.show/v1/player.html?ak=Lm9LJaufCztZXJ5gpNg2&ck=1c042f398773 |
일반 인증 정보를 포함하여 플레이어를 호출 | |
JWT token을 포함하여 플레이어를 호출 | https://www.shoplive.show/v1/player.html?ak=Lm9LJaufCztZXJ5gpNg2&ck=1c042f398773&tk={JWT_TOKEN} |