파일 목록 조회

Request
GET https://api.coolsms.co.kr/storage/v1/files
한 계정이 가지고 있는 파일들의 목록을 조회합니다.
Authorization 인증 필요 [?]​
계정 권한
회원 권한
계정 상태
회원 상태
계정 인증
storage:read
​
ACTIVE
ACTIVE
​
Query Params
Name
Type
Required
Allowed Operator [?]​
Description
fileId
string
​
eq
파일 고유 아이디
name
string
​
eq
파일 이름
url
string
​
eq
파일 주소
originalName
string
​
eq
원본 파일 이름
handleKey
string
​
eq
참조의 핸들키
category
string
​
eq
참조 이름
refId
string
​
eq
참조 대상의 리소스 아이디
dateCreated
date
​
eq
최초 생성 날짜
dateUpdated
date
​
eq
최근 수정 날짜
startKey
string
​
eq
현재 목록을 불러올 기준이 되는 키
limit
number
​
eq
한 페이지에 불러옥 목록 개수
type
string
​
eq
문서 타입(DOCUMENT, KAKAO, MMS)
useDaou
boolean
​
eq
[카카오 채널] 다우기술 이미지 연동 여부
useBiztalk
boolean
​
eq
[카카오 채널] 비즈톡 이미지 연동 여부
Samples
getFileList.spec.js
Sample Request
http://api.coolsms.co.kr/storage/v1/files
Sample Response
{
    "fileList": [
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름34",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID20092304334104438hwt31oH2U",
            "accountId": "19013037529548",
            "name": "파일 이름34",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043341044E9Oon6Wjfy1",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043341044kEFQ1piSl4a"
                }
            ],
            "dateCreated": "2020-09-23T03:33:41.045Z",
            "dateUpdated": "2020-09-23T03:33:41.045Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름33",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043341038CPh3a2cP2tl",
            "accountId": "19013037529548",
            "name": "파일 이름33",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043341038lAT9z1vlfbz",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043341038CGdWrs0wFXm"
                }
            ],
            "dateCreated": "2020-09-23T03:33:41.040Z",
            "dateUpdated": "2020-09-23T03:33:41.040Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름32",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043341033kfQtax8oxsp",
            "accountId": "19013037529548",
            "name": "파일 이름32",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043341033mvwVoblxHVG",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043341033ESLuEcqlPc5"
                }
            ],
            "dateCreated": "2020-09-23T03:33:41.034Z",
            "dateUpdated": "2020-09-23T03:33:41.034Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름31",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043341028hw27kObyvWg",
            "accountId": "19013037529548",
            "name": "파일 이름31",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043341028X7OVuBKAf8m",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043341028nWTmLsyAFCI"
                }
            ],
            "dateCreated": "2020-09-23T03:33:41.029Z",
            "dateUpdated": "2020-09-23T03:33:41.029Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름30",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043341024kho3jc4I2Av",
            "accountId": "19013037529548",
            "name": "파일 이름30",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043341024EMAKd1k9qCB",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043341024fKBaeTYF9RS"
                }
            ],
            "dateCreated": "2020-09-23T03:33:41.025Z",
            "dateUpdated": "2020-09-23T03:33:41.025Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름29",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID20092304334101830jgL7PT549",
            "accountId": "19013037529548",
            "name": "파일 이름29",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043341019jr51bZOSZeD",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043341019UwUCeUt01DE"
                }
            ],
            "dateCreated": "2020-09-23T03:33:41.019Z",
            "dateUpdated": "2020-09-23T03:33:41.019Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름28",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043341014PVP8SE7ADn4",
            "accountId": "19013037529548",
            "name": "파일 이름28",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043341014SW6jJDzTf2m",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043341014KkSRYgJVOFe"
                }
            ],
            "dateCreated": "2020-09-23T03:33:41.015Z",
            "dateUpdated": "2020-09-23T03:33:41.015Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름27",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID2009230433410096yHZJtH8zbj",
            "accountId": "19013037529548",
            "name": "파일 이름27",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043341009JYiwHxYVytS",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043341009QyUHCMVf6cm"
                }
            ],
            "dateCreated": "2020-09-23T03:33:41.010Z",
            "dateUpdated": "2020-09-23T03:33:41.010Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름26",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043341005oVDYQaPjkkP",
            "accountId": "19013037529548",
            "name": "파일 이름26",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043341005nGUVq6kShHc",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043341005h4we9Ax8Rtx"
                }
            ],
            "dateCreated": "2020-09-23T03:33:41.006Z",
            "dateUpdated": "2020-09-23T03:33:41.006Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름25",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043341000OndpntQ1SxD",
            "accountId": "19013037529548",
            "name": "파일 이름25",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043341000EkTxzl0eSpP",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043341000LOcc0POowC9"
                }
            ],
            "dateCreated": "2020-09-23T03:33:41.001Z",
            "dateUpdated": "2020-09-23T03:33:41.001Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름24",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043340996gnKdGcAAWyz",
            "accountId": "19013037529548",
            "name": "파일 이름24",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043340996ZSU7wBtpNVT",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043340996q0petfCdtBP"
                }
            ],
            "dateCreated": "2020-09-23T03:33:40.997Z",
            "dateUpdated": "2020-09-23T03:33:40.997Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름23",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043340989rciHdGaZwIn",
            "accountId": "19013037529548",
            "name": "파일 이름23",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043340989se1U36U34Ky",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043340989alE4ozcxbfx"
                }
            ],
            "dateCreated": "2020-09-23T03:33:40.991Z",
            "dateUpdated": "2020-09-23T03:33:40.991Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름22",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043340983NyJsHJtHvHu",
            "accountId": "19013037529548",
            "name": "파일 이름22",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043340983Asl75D9Egdn",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043340983cJQyIcwzizt"
                }
            ],
            "dateCreated": "2020-09-23T03:33:40.984Z",
            "dateUpdated": "2020-09-23T03:33:40.984Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름21",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043340978b4lRqhLMrzd",
            "accountId": "19013037529548",
            "name": "파일 이름21",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043340978OQfGLUxS42u",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043340978eJzAFVxsUwW"
                }
            ],
            "dateCreated": "2020-09-23T03:33:40.979Z",
            "dateUpdated": "2020-09-23T03:33:40.979Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": null
            },
            "type": "DOCUMENT",
            "originalName": "파일 원본 이름20",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043340971OkeUvqwiySL",
            "accountId": "19013037529548",
            "name": "파일 이름20",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043340971CVppAmIjqTO",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043340971RCbTqyIfZQx"
                }
            ],
            "dateCreated": "2020-09-23T03:33:40.972Z",
            "dateUpdated": "2020-09-23T03:33:40.972Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": "https://solapi.com"
            },
            "type": "KAKAO",
            "originalName": "파일 원본 이름19",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043340966qEu1nbYqYzS",
            "accountId": "19013037529548",
            "name": "파일 이름19",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043340966A2xbHmXjrWF",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043340966zB2AZcpPGAC"
                }
            ],
            "dateCreated": "2020-09-23T03:33:40.968Z",
            "dateUpdated": "2020-09-23T03:33:40.968Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": "https://solapi.com"
            },
            "type": "KAKAO",
            "originalName": "파일 원본 이름18",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID200923043340961Xixd5S2vBS4",
            "accountId": "19013037529548",
            "name": "파일 이름18",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043340961tPkVTeyl2eH",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043340961IbRdiQSzNrn"
                }
            ],
            "dateCreated": "2020-09-23T03:33:40.963Z",
            "dateUpdated": "2020-09-23T03:33:40.963Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": "https://solapi.com"
            },
            "type": "KAKAO",
            "originalName": "파일 원본 이름17",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID2009230433409568wPKBNr0FCM",
            "accountId": "19013037529548",
            "name": "파일 이름17",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043340956DoV6CBWgHD6",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043340956cP4hKbhyAbd"
                }
            ],
            "dateCreated": "2020-09-23T03:33:40.958Z",
            "dateUpdated": "2020-09-23T03:33:40.958Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": "https://solapi.com"
            },
            "type": "KAKAO",
            "originalName": "파일 원본 이름16",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID2009230433409465ugxpl3zAms",
            "accountId": "19013037529548",
            "name": "파일 이름16",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043340946ve6AJzUzk8g",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043340946q7oaU28Zerx"
                }
            ],
            "dateCreated": "2020-09-23T03:33:40.947Z",
            "dateUpdated": "2020-09-23T03:33:40.947Z"
        },
        {
            "kakao": {
                "daou": null,
                "biztalk": "https://solapi.com"
            },
            "type": "KAKAO",
            "originalName": "파일 원본 이름15",
            "link": null,
            "width": null,
            "height": null,
            "fileSize": null,
            "fileId": "FILEID2009230433409409ZzIG1ZPg7S",
            "accountId": "19013037529548",
            "name": "파일 이름15",
            "url": "https://coolsms.co.kr/godori",
            "references": [
                {
                    "handleKey": "REFERE200923043340940DsUGqn7gtDc",
                    "category": "SENDERID_APPROVAL",
                    "refId": "REFID5200923043340940Xk9g4tZML9g"
                }
            ],
            "dateCreated": "2020-09-23T03:33:40.941Z",
            "dateUpdated": "2020-09-23T03:33:40.941Z"
        }
    ],
    "startKey": null,
    "nextKey": "FILEID200923043340935aYu26RpyNJu"
}
Sample Code
NODE
PHP
PYTHON
CURL
RUBY
GO
JAVA
NODE
var request = require('request');
​
var options = {
  headers: {
    Authorization:
      'HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4'
  },
  method: 'GET',
  json: true,
  url: 'http://api.coolsms.co.kr/storage/v1/files'
};
​
request(options, function(error, response, body) {
  if (error) throw error;
  console.log('result :', body);
});
PHP
<?php
$url = "http://api.coolsms.co.kr/storage/v1/files";
​
$options = array(
    'http' => array(
        'header'  => "Authorization: HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4\r\n",
        'method'  => 'GET'
    )
);
​
$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);
​
var_dump($result);
PYTHON
import requests
​
url = "http://api.coolsms.co.kr/storage/v1/files"
headers = {
  "Authorization": "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4"
}
​
response = requests.get(url, headers=headers)
print(response.status_code)
print(response.text)
CURL
#!/bin/bash
curl -X GET \
    -H 'Authorization: HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4' \
    http://api.coolsms.co.kr/storage/v1/files
RUBY
require 'net/http'
require 'uri'
require 'json'
​
uri = URI.parse("http://api.coolsms.co.kr/storage/v1/files")
​
headers = {
  "Authorization": "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4"
}
http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Get.new(uri.request_uri, headers)
​
response = http.request(request)
puts response.code
puts response.body
GO
package main
​
import (
  "fmt"
  "io/ioutil"
  "net/http"
  "strings"
)
​
func main() {
  uri := "http://api.coolsms.co.kr/storage/v1/files"
​
  req, err := http.NewRequest("GET", uri, nil)
  if err != nil { panic(err) }
​
  req.Header.Set("Authorization", "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4")
​
  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
​
  bytes, _ := ioutil.ReadAll(resp.Body)
  str := string(bytes)
  fmt.Println(str)
}
JAVA
package solapi;
​
import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
​
public class Request {
  public static void main(String[] args) throws Exception {
    String targetUrl = "http://api.coolsms.co.kr/storage/v1/files";
​
    URL url = new URL(targetUrl);
    HttpURLConnection con = (HttpURLConnection) url.openConnection();
​
    con.setRequestMethod("GET");
​
    con.setRequestProperty("Authorization", "HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4");
​
    con.setDoOutput(true);
    DataOutputStream wr = new DataOutputStream(con.getOutputStream());
    wr.writeBytes(parameters);
    wr.flush();
    wr.close();
​
    int responseCode = con.getResponseCode();
    BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
    String line;
    StringBuffer response = new StringBuffer();
    while ((line = in.readLine()) != null) {
      response.append(line);
    }
    in.close();
​
    System.out.println("HTTP response code : " + responseCode);
    System.out.println("HTTP body : " + response.toString());
  }
}
문서 생성일 : 2020-09-23
파일 조회
파일 업로드
Last updated 4 months ago
계정 권한	회원 권한	계정 상태	회원 상태	계정 인증
`storage:read`		`ACTIVE`	`ACTIVE`
Name	Type	Required	Allowed Operator [?]	Description
fileId	`string`		eq	파일 고유 아이디
name	`string`		eq	파일 이름
url	`string`		eq	파일 주소
originalName	`string`		eq	원본 파일 이름
handleKey	`string`		eq	참조의 핸들키
category	`string`		eq	참조 이름
refId	`string`		eq	참조 대상의 리소스 아이디
dateCreated	`date`		eq	최초 생성 날짜
dateUpdated	`date`		eq	최근 수정 날짜
startKey	`string`		eq	현재 목록을 불러올 기준이 되는 키
limit	`number`		eq	한 페이지에 불러옥 목록 개수
type	`string`		eq	문서 타입(DOCUMENT, KAKAO, MMS)
useDaou	`boolean`		eq	[카카오 채널] 다우기술 이미지 연동 여부
useBiztalk	`boolean`		eq	[카카오 채널] 비즈톡 이미지 연동 여부
파일 목록 조회

Request

Authorization 인증 필요 [?]​

Query Params

Samples

getFileList.spec.js

Authorization 인증 필요 [?]
