shoplive.show (샵라이브 제공 페이지)

이 페이지에서는 Shoplive에서 제공하는 shoplive.show 도메인 기반의 플레이어 페이지를 고객사의 웹사이트 / 모바일 어플리케이션(Web view)에 연동하기 위한 가이드를 제공합니다.

Shoplive에서는 아래와 같은 방식으로 웹 페이지에 연동할 수 있는 플레이어를 제공하고 있습니다.

• Shoplive JavaScript SDK를 활용한 플레이어 설치
• Shoplive Plugin을 활용한 플레이어 설치
• shoplive.show 도메인에서 제공하는 플레이어 페이지 호출

JavaScript SDK를 통한 설치와 Shoplive Plugin을 통한 설치는 고객사에서 서비스하는 랜딩 페이지가 있어야만 플레이어를 설치할 수 있는데 반해, shoplive.show에서 제공하는 플레이어는 고객사에 별도의 랜딩 페이지가 없이 간단한 URL 호출만으로 플레이어를 실행할 수 있습니다.

shoplive.show에서 제공하는 플레이어 호출을 위한 URL과 parameter는 아래 내용을 참고하시기 바랍니다.

Player URL

https://www.shoplive.show/v1/player.html

URL parameter

인증 정보 설정(tk parameter)

일반 인증 일반 인증 안내

• JSON 객체로 userId, userName 등의 정보를 설정한 후 tk parameter로 Player를 호출할 때 반드시 url encode하여 전달하여야 합니다.
• JSON 객체의 예: {userId: "userID", userName: "userName"}
• tk 파라미터에서 사용할 url encode된 JSON 객체의 예:
  %7B%22userId%22%3A%20%22userID%22%2C%20%22userName%22%3A%22userName%22%7D
• url encode가 두 번 되지 않도록 주의하세요!

JWT 인증 (JWT 인증 안내)

• 고객사 서버에서 secret key로 암호화하여 JWT를 생성한 후 생성된 토큰을 tk parameter로 전달합니다.

예제

• https://www.shoplive.show/v1/player.html?ak={access_key}&tk={JWT_token}&ck={campaign_key}

Guest 사용자를 위한 Player를 호출하는 예 (tk parameter를 전달하지 않음)

• <https://www.shoplive.show/v1/player.html?ak=Lm9LJaufCztZXJ5gpNg2&ck=1c042f398773>

일반 인증 정보를 포함하여 Player를 호출하는 예

• <https://www.shoplive.show/v1/player.html?ak=Lm9LJaufCztZXJ5gpNg2&ck=1c042f398773&tk=%7B%22userId%22%3A%20%22userID%22%2C%20%22userName%22%3A%22userName%22%7D>

JWT 토큰을 포함하여 Player를 호출하는 예

• <https://www.shoplive.show/v1/player.html?ak=Lm9LJaufCztZXJ5gpNg2&ck=1c042f398773&tk={JWT_TOKEN}>