v2 documentation
+
+
POST
/content
DELETE
/content/{no}
GET
/contents
+
POST
/ownership
+
+
DELETE
/user/{no}
GET
/users
토큰 검증
GET
/auth/check
/www/default/api_tmashorts/domain/auth/auth.php
Returns
Name Type Description
success boolean 성공 여부
message string 메시지
회원탈퇴
GET
/auth/exit
/www/default/api_tmashorts/domain/auth/auth.php
Returns
Name Type Description
success boolean 성공 여부
message string 메시지
토큰 갱신
POST
/auth/refresh
/www/default/api_tmashorts/domain/auth/auth.php
Returns
Name Type Description
success boolean 성공 여부
user_no [int] 회원 번호
access_token string 새로운 액세스 토큰
refresh_token string 새로운 리프레시 토큰
로그인
POST
/auth/signin
/www/default/api_tmashorts/domain/auth/auth.php
로그인 시도시 회원 정보가 존재하지 않을 경우 회원 정보를 바로 추가

Request Body
Name Type Opt Description
tma_chat_id string TMA 챗아이디
nickname string 닉네임
photo_url string 프로필 이미지 주소
language_code string 언어 코드 (ko, en, ja, zh)
tma_data json TMA 코드 정보
     + auth_date : [string]
     + signature : [string]
     + hash : [string]
user_id string 아이디(웹 로그인 시 사용)
user_pw string 비밀번호(웹 로그인 시 사용)
Returns
Name Type Description
success boolean 성공 여부
data json 토큰 정보
     + access_token : [string] 액세스 토큰
     + refresh_token : [string] 리프레시 토큰
     + expire_in : [int] 토큰 만료 시간(초)
로그아웃
GET
/auth/signout
/www/default/api_tmashorts/domain/auth/auth.php
모든 장치에서 로그아웃
Returns
Name Type Description
success boolean 성공 여부
message string 메시지
코드 타입 리스트 조회
GET
/code/list
/www/default/api_tmashorts/domain/code/code.php
정의된 모든 코드타입을 반환
Returns
Name Type Description
success boolean 성공 여부(true/false)
data array 코드 타입 리스트
+no : [integer] 코드 타입 번호
+code_type : [string] 코드
+code_type_name : [String] 코드 타입 이름
+codes : [Array] 코드 리스트
     +code : [String] 코드
     +name : [String] 코드 이름
코드 조회
GET
/code/{code_type}
/www/default/api_tmashorts/domain/code/code.php
URL Parameters
Name Type Description
code_type string 코드 타입
Returns
Name Type Description
success boolean 성공 여부(true/false)
data array 코드 리스트
+code : [string] 코드
+name : [string] 코드 이름
싫어요 추가
POST
/comment/dislike/{parent_type}/{parent_no}
/www/default/api_tmashorts/domain/comment/like.php
URL Parameters
Name Type Description
parent_type string 부모 (PARENT_TYPE_CONTENT / PARENT_TYPE_SEASON / PARENT_TYPE_EPISODE / PARENT_TYPE_COMMENT)
parent_no [int] 부모 번호
Returns
종아요 삭제
DELETE
/comment/like/{like_no}
/www/default/api_tmashorts/domain/comment/like.php
URL Parameters
Name Type Description
like_no [int] 종아요 번호
Returns
종아요 추가
POST
/comment/like/{parent_type}/{parent_no}
/www/default/api_tmashorts/domain/comment/like.php
URL Parameters
Name Type Description
parent_type string 부모 (PARENT_TYPE_CONTENT / PARENT_TYPE_SEASON / PARENT_TYPE_EPISODE / PARENT_TYPE_COMMENT)
parent_no [int] 부모 번호
Request Body
Name Type Opt Description
user_no [int] 회원 번호
Returns
댓글 삭제
DELETE
/comment/{comment_no}
/www/default/api_tmashorts/domain/comment/comment.php
URL Parameters
Name Type Description
comment_no [int] 댓글 no
Returns
댓글 수정
PUT
/comment/{comment_no}
/www/default/api_tmashorts/domain/comment/comment.php
URL Parameters
Name Type Description
comment_no [int] 댓글 번호
Request Body
Name Type Opt Description
user_no [int] 회원 번호
content string 댓글 내용
Returns
댓글 추가
POST
/comment/{parent_type}/{parent_no}
/www/default/api_tmashorts/domain/comment/comment.php
URL Parameters
Name Type Description
parent_type string 부모 (PARENT_TYPE_CONTENT / PARENT_TYPE_SEASON / PARENT_TYPE_EPISODE / PARENT_TYPE_COMMENT)
parent_no [int] 부모 번호
Request Body
Name Type Opt Description
user_no [int] 회원 번호
content string 댓글 내용
Returns
댓글 목록 조회(by user)
GET
/comments/user/{user_no}
/www/default/api_tmashorts/domain/comment/comment.php
URL Parameters
Name Type Description
user_no [int] 회원 번호
Returns
댓글 목록 조회
GET
/comments/{parent_type}/{parent_no}
/www/default/api_tmashorts/domain/comment/comment.php
URL Parameters
Name Type Description
parent_type string 부모 (PARENT_TYPE_CONTENT / PARENT_TYPE_SEASON / PARENT_TYPE_EPISODE / PARENT_TYPE_COMMENT)
parent_no [int] 부모 번호
Returns
컨텐츠 추가
POST
/content
/www/default/api_tmashorts/domain/content/content.php
Request Body
Name Type Opt Description
title string 컨텐츠 제목
description string 컨텐츠 설명
thumbnail string base64 인코딩 이미지
Returns
Name Type Description
data json 컨텐츠 정보
id : [int] 컨텐츠 아이디
에피소드 조회수 증가
POST
/content/episode/add/view/{eno}
/www/default/api_tmashorts/domain/content/episode.php
URL Parameters
Name Type Description
eno [int] 에피소드 번호
Returns
에피소드 구간 설정 추가
POST
/content/episode/{eno}/section
/www/default/api_tmashorts/domain/content/epiosde.section.php
URL Parameters
Name Type Description
eno [int] 에피소드 번호
Request Body
Name Type Opt Description
title string 구간 제목
description string 구간 설명
section_type string 구간 타입 (block / advisor / view advertisement)
thumbnail string 구간 썸네일
start_time [int] 시작 시간
end_time [int] 종료 시간
Returns
에피소드 구간 설정 삭제
DELETE
/content/episode/{eno}/section/{section_no}
/www/default/api_tmashorts/domain/content/epiosde.section.php
URL Parameters
Name Type Description
eno [int] 에피소드 번호
section_no [int] 구간 번호
Returns
에피소드 구간 설정 수정
PUT
/content/episode/{eno}/section/{section_no}
/www/default/api_tmashorts/domain/content/epiosde.section.php
URL Parameters
Name Type Description
eno [int] 에피소드 번호
section_no [int] 구간 번호
Request Body
Name Type Opt Description
title string 구간 제목
description string 구간 설명
section_type string 구간 타입 (block / advisor / view advertisement)
thumbnail string 구간 썸네일
start_time [int] 시작 시간
end_time [int] 종료 시간
Returns
에피소드 구간 설정 목록 조회
GET
/content/episode/{eno}/sections
/www/default/api_tmashorts/domain/content/epiosde.section.php
URL Parameters
Name Type Description
eno [int] 에피소드 번호
Returns
에피소드 추가
POST
/content/episode/{sno}
/www/default/api_tmashorts/domain/content/episode.php
URL Parameters
Name Type Description
sno [int] 시즌 번호
Request Body
Name Type Opt Description
title string 에피소드 제목
description string 에피소드 설명
thumbnail string base64 인코딩 이미지
Returns
에피소드 수정
PUT
/content/episode/{sno}/{eno}
/www/default/api_tmashorts/domain/content/episode.php
URL Parameters
Name Type Description
sno [int] 시즌 번호
eno [int] 에피소드 번호
Request Body
Name Type Opt Description
title string 에피소드 제목
description string 에피소드 설명
thumbnail string base64 인코딩 이미지
Returns
에피소드 조회
GET
/content/episode/{sno}/{eno}
/www/default/api_tmashorts/domain/content/episode.php
URL Parameters
Name Type Description
sno [int] 시즌 번호
eno [int] 에피소드 번호
Returns
에피소드 삭제
DELETE
/content/episode/{sno}/{eno}
/www/default/api_tmashorts/domain/content/episode.php
URL Parameters
Name Type Description
sno [int] 시즌 번호
eno [int] 에피소드 번호
Returns
에피소드 목록 조회
GET
/content/episodes/{sno}
/www/default/api_tmashorts/domain/content/episode.php
URL Parameters
Name Type Description
sno [int] 시즌 번호
Returns
시즌 추가
POST
/content/season
/www/default/api_tmashorts/domain/content/season.php
Request Body
Name Type Opt Description
title string 시즌 제목
description string 시즌 설명
thumbnail string base64 인코딩 이미지
Returns
시즌 조회
GET
/content/season/{no}
/www/default/api_tmashorts/domain/content/season.php
URL Parameters
Name Type Description
no [int] 시즌 번호
Returns
시즌 수정
PUT
/content/season/{no}
/www/default/api_tmashorts/domain/content/season.php
URL Parameters
Name Type Description
no [int] 시즌 번호
Request Body
Name Type Opt Description
title string 시즌 제목
description string 시즌 설명
thumbnail string base64 인코딩 이미지
Returns
시즌 삭제
DELETE
/content/season/{no}
/www/default/api_tmashorts/domain/content/season.php
URL Parameters
Name Type Description
no [int] 시즌 번호
Returns
시즌 목록 조회
GET
/content/seasons
/www/default/api_tmashorts/domain/content/season.php
Returns
컨텐츠 정보 조회
GET
/content/{no}
/www/default/api_tmashorts/domain/content/content.php
Returns
컨텐츠 삭제
DELETE
/content/{no}
/www/default/api_tmashorts/domain/content/content.php
URL Parameters
Name Type Description
no [int] 컨텐츠 no
Returns
컨텐츠 수정
PUT
/content/{no}
/www/default/api_tmashorts/domain/content/content.php
URL Parameters
Name Type Description
no [int] 컨텐츠 아이디
Returns
컨텐츠 목록 조회
GET
/contents
/www/default/api_tmashorts/domain/content/content.php
Returns
성인인증 이력 추가
POST
/history/adult_cert
/www/default/api_tmashorts/domain/history/adult_cert.php
Returns
성인인증 이력 삭제
DELETE
/history/adult_cert/{adult_cert_no}
/www/default/api_tmashorts/domain/history/adult_cert.php
Returns
성인인증 이력 목록 조회
GET
/history/adult_certs
/www/default/api_tmashorts/domain/history/adult_cert.php
Returns
구매 이력 삭제
DELETE
/history/purchase/{purchase_no}
/www/default/api_tmashorts/domain/history/purchase.php
URL Parameters
Name Type Description
purchase_no [int] 구매 이력 번호
Returns
구매 이력 추가
POST
/history/purchase/{thing_type}/{thing_no}
/www/default/api_tmashorts/domain/history/purchase.php
URL Parameters
Name Type Description
thing_type string 구매 이력 타입(content / season / episode)
thing_no [int] 구매 이력 번호
Request Body
Name Type Opt Description
user_no [int] 회원 번호
thing_type string 물품 타입(content / season / episode)
thing_no [int] 물품 번호
price [int] 구매 가격
date_own_start string 소유 시작일
date_own_end string 소유 종료일
Returns
구매 이력 목록 조회
GET
/history/purchases/{thing_type}/{thing_no}
/www/default/api_tmashorts/domain/history/purchase.php
URL Parameters
Name Type Description
thing_type string 구매 이력 타입(content / season / episode / member)
thing_no [int] 구매 이력 번호
Returns
시청 이력 추가
POST
/history/view
/www/default/api_tmashorts/domain/history/view.php
Request Body
Name Type Opt Description
user_no [int] 회원 번호
thing_type string 물품 타입(content / season / episode)
thing_no [int] 물품 번호
date_view string 시청 일자
ms_duration [int] 시청 시간(ms)
Returns
시청 이력 목록 조회
GET
/history/views/{content_no}
/www/default/api_tmashorts/domain/history/view.php
URL Parameters
Name Type Description
content_no [int] 컨텐츠 번호
Returns
회원 정보 수정
PUT
/member/{no}
/www/default/api_tmashorts/domain/user/user.php
Returns
소유권 추가
POST
/ownership
/www/default/api_tmashorts/domain/ownership/ownership.php
Request Body
Name Type Opt Description
user_no [int] 회원 번호
thing_type string 소유권 타입 (content / season / episode)
thing_no [int] 소유권 번호
price [int] 가격
date_start string 시작일
date_end string 종료일
Returns
소유권 삭제
DELETE
/ownership/{ownership_no}
/www/default/api_tmashorts/domain/ownership/ownership.php
Returns
소유권 수정
PUT
/ownership/{ownership_no}
/www/default/api_tmashorts/domain/ownership/ownership.php
Request Body
Name Type Opt Description
thing_type string 소유권 타입 (content / season / episode)
thing_no [int] 소유권 번호
price [int] 가격
date_start string 시작일
date_end string 종료일
Returns
소유권 목록 조회 by thing(content / season / episode / member)
GET
/ownerships/{thing_type}/{thing_no}
/www/default/api_tmashorts/domain/ownership/ownership.php
URL Parameters
Name Type Description
thing_type string 소유권 타입 (content / season / episode / member)
thing_no [int] 소유권 번호
Returns
api test page
GET
/test/index
/www/default/api_tmashorts/domain/test/test.php


Request Body
Name Type Opt Description
a string a
b string b
Returns
Name Type Description
result bool true or false
name string name
금일 출석 체크
POST
/user/checkin
/www/default/api_tmashorts/domain/user/user.php
Returns
Name Type Description
success boolean 성공 여부
message string 메시지
출석 체크 목록 조회
GET
/user/checkins
/www/default/api_tmashorts/domain/user/user.php
Query String
Name Type Opt Description
num number 조회 개수 (default: 7)
Returns
Name Type Description
success boolean 성공 여부
data
     + list : [array] 출석 체크 목록
         + date_create : [number] timestamp
         + consecutive_days : [number] 연속 출석 일수(금일 포함, 금일 출석 안했을 경우 0)
회원 포인트 정보
GET
/user/point/{point_type}
/www/default/api_tmashorts/domain/user/user.php
URL Parameters
Name Type Description
point_type string 포인트 타입 (POINT_WON / POINT_COIN / ... 포인트 정보 추가 예정)
Returns
회원 정보 조회
GET
/user/{no}
/www/default/api_tmashorts/domain/user/user.php
URL Parameters
Name Type Description
no number 회원 번호
Returns
회원 탈퇴
DELETE
/user/{no}
/www/default/api_tmashorts/domain/user/user.php
Returns
회원 목록 조회
GET
/users
/www/default/api_tmashorts/domain/user/user.php
URL Parameters
Name Type Description
success boolean 성공 여부
data array 회원 목록
     + user_no : [number] 회원 번호
     + nickname : [string] 닉네임
     + user_id : [string] 아이디
     + tma_chat_id : [string] TMA 챗아이디
     + created_at : [string] 가입일
     + is_delete : [boolean] 탈퇴 여부
Returns