Storage API

스토리지(파일/디렉토리) 관련 API Wiki

Basic Storage Control API

Upload File

POST http(s)://[server-host]:[server-port]/server/storage/data/file/:user/:root

파일 업로드 하기

Path Parameters

Name	Type	Description
root	string	target directory that file will be uploaded
user	string	target user static id

Headers

Name	Type	Description
Set-Cookie	string	token

Request Body

Name	Type	Description
file	string	uploaded file

200 return 0 if success

{ code: [integer] }

Get File Info

GET http(s)://[server-host]:[server-port]/server/storage/data/file/:user/:root

파일 정보 갖고오기 (Raw Data 제외)

Path Parameters

Name	Type	Description
user	string	target user
root	string	target file root

Headers

Name	Type	Description
Set-Cookie	string	token

200

{
    code: 0,
    data: {
        create-date: YYYY/MM/DD HH:MM:SS,
        modify-date: YYYY/MM/DD HH:MM:SS,
        file-name: [file name],
        file-type: [TEXT, IMAGE, AUDIO, ETC...],
        size: {
            size-type: [KB, MB, ETC...],
            size-volume: [float]
        }
    }
}

Modify File Info

PATCH http(s)://[server-host]:[server-port]/server/storage/data/file/:user/:root

파일 정보 수정 수정 내역 1. 파일 이름

Path Parameters

Name	Type	Description
user	string	target user
root	string	target file root

Headers

Name	Type	Description
Set-Cookie	string	token

Request Body

Name	Type	Description
filename	string	new filename

200 if success return code 0

{ code: [integer] {

Delete File

DELETE http(s)://[server-host]:[server-port]/server/storage/data/file/:user/:root

파일 삭제

Path Parameters

Name	Type	Description
user	string	target user
root	string	target directory that file will be uploaded

Headers

Name	Type	Description
Set-Cookie	string	token

200 if success then return 0

{ code: [integer] }

Generate Directory

POST http(s)://[server-host]:[server-port]/server/storage/data/dir/:user/:root

디렉토리 생성

Path Parameters

Name	Type	Description
root	string	new directory root
user	string	target user

Headers

Name	Type	Description
Set-Cookie	string	token

200 if success then return 0

{ code: [integer] }

Modify Directory

PATCH http(s)://[server-host]:[server-port]/server/storage/data/dir/:user/:root

디렉토리 정보 수정

Path Parameters

Name	Type	Description
user	string	target user
root	string	target directory

Headers

Name	Type	Description
Set-Cookie	string	token

Request Body

Name	Type	Description
dir-name	string	new directory name

200 return 0 if success

{ code: [integer] }

Get Directory Info

GET http(s)://[server-host]:[server-port]/server/storage/data/dir/:user/:root

디렉토리 정보 갖고오기(Raw Data 제외)

Path Parameters

Name	Type	Description
user	string	target user
root	string	target directory root

Headers

Name	Type	Description
Set-Cookie	string	token

200 if success then return code 0 and data

{
    code: 0,
    data: {
        info: {
            create-date: YYYY/MM/DD HH:MM:SS,
            modify-date: YYYY/MM/DD HH:MM:SS,
            dir-name: [directory name],
            file-size: [size of file]
        },
        list: {
            file: [
                {fileinfo}, {}, ...
            ],
            dir: [
                {dirinfo}, {}, ...
            ]
        }
    }
}

Delete Directory (Recursive)

DELETE http(s)://[server-host]:[server-port]/server/storage/data/dir/:user/:root

디렉토리 삭제하기

Path Parameters

Name	Type	Description
user	string	target user
root	string	target directory root

Headers

Name	Type	Description
Set-Cookie	string	token

200 return 0 if success

{ code: 0 }

Shared Function API

해당 File이 공유되어있는 지 확인하고 공유되어 있으면 shared-id 받기

GET http(s)://[server-host]:[server-port]/server/storage/shared/file/:file-root

Share

Path Parameters

Name	Type	Description
file-root*	String	Target File Root

Cookies

Name	Type	Description
token*	String	Auth token

200: OK If is shared get shared-id

{
    "code": 0,
    "data": {
        "shared-id": [shared-id]
    }
}

200: OK if not shared get error code

{
    "code": [x > 0]
}

File 공유 등록 하기

POST http(s)://[server-host]:[server-port]/server/storage/shared/file

Cookies

Name	Type	Description
token*	String	Auth token

Request Body

Name	Type	Description
file-root*	String	Target File Root

200: OK return code 0 with new shared id if succeed else return over 0

{
    "code": [x > 0],
    "data": {
        "shared-id": "xxxxxxxxxxxxxxxxx"
    }
}

공유된 파일 다운로드 하기

GET http(s)://[server-host]:[server-port]/server/storage/shared/file/:shared-id

Path Parameters

Name	Type	Description
shared-id*	String	target file shared id

200: OK if succeed return raw file data

{
    // Response
}

200: OK if failed return error code

{
    "code": [x > 0]
}

공유 파일 해제

DELETE http(s)://[server-host]:[server-port]/server/storage/shared/file/:shared-id

Path Parameters

Name	Type	Description
shared-id	String	Target Shared id for unshare

Cookies

Name	Type	Description
token*	String	Auth token

200: OK return 0 if succeed else over 0

{
    "code": int
}