...
채널에 Play 콜백 URL을 설정합니다.
ex> http://www.foo.com/auth.php 가 고객사 Play 콜백 서버인 경우
JSON 데이터를 생성 후 JWT로 인코딩 한다.
Kollus mobile player가 http://www.foo.com/auth.php 에 다음의 정보를 POST 전송 합니다.
kind : 1, 3
client_user_id : 고객사 회원 아이디
Media token 생성시 포함된 아이디입니다.
player_id : 고객사 회원이 가지고 있는 단말 아이디
device_name : 고객사 회원이 가지고 있는 단말명
media_content_key : 현재 재생하려는 콘텐츠 key 입니다.
채널에 등록된 컨텐츠에 부여된 고유 키입니다.
업로드된 컨텐츠를 여러채널에 등록하면 media_content_key는 모두 다르게 생성됩니다.
고객사 Play 콜백 서버는 전달 받은 위 정보를 바탕으로 다음의 json 포멧의 data를 JWT의 payload 에 추가하여 Encoding 하고 헤더에 지정된 “시용자키(X-KOLLUS-USERKEY)"를 함께 전송합니다.
(고객사가 인증 정보를 플레이어로 전달할 때 모든 데이터의 자료형은 반드시 기술된대로 integer 형이여야만 합니다.)
Response JSON spec.
Json Tag | Description |
|---|---|
expiration_date | unixtime stamp (만료될 시간의 unixtime stamp) |
result | 반환 결과가 정상인 경우 1, 비정상인 경우 0을 반환하도록 합니다. |
content_expired | DRM 컨텐츠를 강제로 expire 시킵니다. |
Callback Kind
Play 콜백이 호출되는 상황은 아래 3가지 경우입니다.
콘텐츠의 Expire 정보를 요청하는 경우 (kind:1)
Request
구분 | Description |
|---|---|
POST | Http POST로 요청합니다. (parameter가 아닙니다.) |
kind | 1 |
client_user_id | 고객사 사용자 ID, media_token 생성시 사용된 client_user_id와 동일합니다. |
player_id | 고객사 사용자가 가지고 있는 단말의 아이디 |
hardware_id | 단말의 hardware 아이디(PC, 입력값이 있으면) |
device_name | 고객사 사용자가 가지고 있는 단말의 모델명 |
media_content_key | Kollus 컨텐츠 unique key |
uservalues | JSON format (VideoGateway 호출시 사용된 |
uservalue0~999) |
uservalues sample
uservalues={"uservalue0":"강의코드01","uservalue1":"상품코드02","uservalue9":" 생성코드03"}
VideoGateway(v.kr.kollus.com)호출시 사용된 uservalue0~9 uservalue0~999 정보를 함께 전달 받습니다.
Response
카테고리 | 구분 | 필수 | Description |
|---|---|---|---|
Data | (int) expiration_date | O | 만료될 시간의 unixtime stamp |
(int) result | O | 0 (비정상), 1 (정상) | |
(string) message | result == 0 (비정상)의 경우 message를 추가하면 지정 한 메시지가 표출됩니다.
| ||
(int) vmcheck | 0 (사용안함), 1 (사용함, default) virtural machine 체크 여부, PC(v3)용에서만 사용 가능 | ||
(int) disable_tvout | 0 (tvout 차단 안함), 1 (tvout 차단) 이 항목이 없으면 채널에 있는 disable_tvout정책이 적용됩니다. | ||
(int) | 이 항목이 없거나 0이면 재생 시간을 사용하지 않고 0보다 크면 해당 값의 초만큼만 재생 후 종료합니다. | ||
(int) cpcheck | 0 (사용안함), 1 (사용함, default) 캡쳐프로그램 체크 여부, PC용에서만 사용 가능 | ||
exp | (int) | 사용 가능 시간 unixtime stamp(옵션) |
Example
| Code Block | ||
|---|---|---|
| ||
{
“data” : {
"expiration_date": 1402444800,
"vmcheck": 1,
"disable_tvout": 1,
"expiration_playtime": 1800,
"result": 1
},
“exp” : 1477558242
} |
...
주의) 콘텐츠 재생을 위해 반드시 응답해야 합니다. Play 콜백에 대한 응답을 확인 후에 재생을 시작합니다.
Request
구분 | Description |
|---|---|
POST | Http POST로 요청합니다. (parameter가 아닙니다.) |
kind | 3 |
client_user_id | 고객사 사용자 ID, media_token 생성시 사용된 client_user_id와 동일합니다. |
player_id | 고객사 사용자가 가지고 있는 단말의 아이디 |
device_name | 고객사 사용자가 가지고 있는 단말의 모델명 |
media_content_key | Kollus 컨텐츠 unique key |
uservalues | JSON format (VideoGateway 호출시 사용된 uservalue0~9) |
Response
카테고리 | 구분 | 필수 | Description |
|---|---|---|---|
data | (int) content_expired | 0 (재생가능), 1 (재생 제한) | |
(int) result | O | 0 (비정상), 1 (정상) | |
(string) message | result == 0 (비정상)의 경우나 content_expired이 1(재생 제한)의 경우 message를 추가하면 지정 한 메시지가 표출됩니다.
| ||
exp | (int) expiration_date | 사용 가능 시간 unixtime stamp(옵션) |
Example
| Code Block | ||
|---|---|---|
| ||
{
“data” : {
"content_expired": 1,
"result": 1
},
"exp" : 1477558242
} |
...