Comment on page
잔액 변동내역 조회

Request
GET https://api.coolsms.co.kr/cash/v1/balance/history
메시지 발송, 출금등으로 변동 된 잔액 내역을 조회합니다.
Authorization 인증 필요 [?]​
계정 권한
회원 권한
계정 상태
회원 상태
계정 인증
cash:read
role-cash:read
​
​
​
Query Params
Name
Type
Required
Allowed Operator [?]​
Description
​
offset
number
​
eq
검색 시작 지점
​
limit
number
​
eq
한 페이지에 불러옥 목록 개수
​
startDate
string
​
eq
검색 날짜 시작 범위
​
endDate
string
​
eq
검색 날짜 끝 범위
​
type
string
​
eq
충전 및 차감 타입
​
groupId
string
​
eq
메시지 그룹 ID
​
rechargeMethod
string
​
eq
결제 수단 (STRIPE
ACCOUNT-TRANSFER)
serviceMethod
string
​
eq
사용 서비스 (MT)
​
balanceAmount
number
​
eq
사용 금액
​
balanceRecharge
boolean
​
eq
잔액 충전 여부
​
balanceDeduct
boolean
​
eq
잔액 차감 여부
​
pointRecharge
boolean
​
eq
포인트 충전 여부
​
pointDeduct
boolean
​
eq
포인트 차감 여부
​
Samples
getBalanceHistory.spec.js
Sample Request
http://api.coolsms.co.kr/cash/v1/balance/history
Sample Response
[
    {
        "balanceAmount": 0,
        "pointAmount": 100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 0,
        "newPoint": 100,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T10:00:00.000Z",
        "historyId": "5db728d9aa83954519463abf"
    },
    {
        "balanceAmount": 0,
        "pointAmount": 100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 0,
        "newPoint": 100,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T10:00:00.000Z",
        "historyId": "5db728d9aa83954519463ac7"
    },
    {
        "balanceAmount": 0,
        "pointAmount": 100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 0,
        "newPoint": 100,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T10:00:00.000Z",
        "historyId": "5db728d9aa83954519463ac5"
    },
    {
        "balanceAmount": 0,
        "pointAmount": 100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 0,
        "newPoint": 100,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T10:00:00.000Z",
        "historyId": "5db728d9aa83954519463ac3"
    },
    {
        "balanceAmount": 0,
        "pointAmount": 100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 0,
        "newPoint": 100,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T10:00:00.000Z",
        "historyId": "5db728d9aa83954519463ac1"
    },
    {
        "balanceAmount": 100,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 100,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T09:00:00.000Z",
        "historyId": "5db728d9aa83954519463aec"
    },
    {
        "balanceAmount": 100,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 100,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T09:00:00.000Z",
        "historyId": "5db728d9aa83954519463ae1"
    },
    {
        "balanceAmount": 100,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 100,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T09:00:00.000Z",
        "historyId": "5db728d9aa83954519463ae8"
    },
    {
        "balanceAmount": 100,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 100,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T09:00:00.000Z",
        "historyId": "5db728d9aa83954519463ade"
    },
    {
        "balanceAmount": 100,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 100,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T09:00:00.000Z",
        "historyId": "5db728d9aa83954519463ae4"
    },
    {
        "balanceAmount": 0,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T08:30:00.000Z",
        "historyId": "5db728d9aa83954519463ad7"
    },
    {
        "balanceAmount": 0,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T08:30:00.000Z",
        "historyId": "5db728d9aa83954519463ae3"
    },
    {
        "balanceAmount": 0,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T08:30:00.000Z",
        "historyId": "5db728d9aa83954519463ad5"
    },
    {
        "balanceAmount": 0,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T08:30:00.000Z",
        "historyId": "5db728d9aa83954519463ae7"
    },
    {
        "balanceAmount": 0,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T08:30:00.000Z",
        "historyId": "5db728d9aa83954519463ad9"
    },
    {
        "balanceAmount": 0,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T08:30:00.000Z",
        "historyId": "5db728d9aa83954519463adb"
    },
    {
        "balanceAmount": 0,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T08:30:00.000Z",
        "historyId": "5db728d9aa83954519463add"
    },
    {
        "balanceAmount": 0,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T08:30:00.000Z",
        "historyId": "5db728d9aa83954519463ad3"
    },
    {
        "balanceAmount": 0,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T08:30:00.000Z",
        "historyId": "5db728d9aa83954519463ae0"
    },
    {
        "balanceAmount": 0,
        "pointAmount": -100,
        "groupId": null,
        "memo": null,
        "rechargeMethod": null,
        "serviceMethod": null,
        "chargedMethod": null,
        "paymentMethod": null,
        "accountId": "19041920726336",
        "oldBalance": 0,
        "newBalance": 0,
        "oldPoint": 300,
        "newPoint": 200,
        "type": "MANUAL",
        "dateCreated": "2018-04-01T08:30:00.000Z",
        "historyId": "5db728d9aa83954519463aeb"
    }
]
Sample Code
NODE
JQUERY
PHP
PYTHON
CURL
RUBY
GO
JAVA
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/cash/v1/balance/history'
};
​
request(options, function(error, response, body) {
  if (error) throw error;
  console.log('result :', body);
});
var options = {
  headers: {
    Authorization:
      'HMAC-SHA256 apiKey=NCSAYU7YDBXYORXC, date=2019-07-01T00:41:48Z, salt=jqsba2jxjnrjor, signature=1779eac71a24cbeeadfa7263cb84b7ea0af1714f5c0270aa30ffd34600e363b4'
  },
  method: 'GET',
  url: 'http://api.coolsms.co.kr/cash/v1/balance/history'
};
​
$.ajax(options).done(function(response) {
  console.log(response);
});
<?php
$url = "http://api.coolsms.co.kr/cash/v1/balance/history";
​
$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);
import requests
​
url = "http://api.coolsms.co.kr/cash/v1/balance/history"
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)
#!/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/cash/v1/balance/history
require 'net/http'
require 'uri'
require 'json'
​
uri = URI.parse("http://api.coolsms.co.kr/cash/v1/balance/history")
​
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
package main
​
import (
  "fmt"
  "io/ioutil"
  "net/http"
  "strings"
)
​
func main() {
  uri := "http://api.coolsms.co.kr/cash/v1/balance/history"
​
  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)
}
package coolsms;
​
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/cash/v1/balance/history";
​
    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());
  }
}
문서 생성일 : 2019-10-28
잔액조회
계좌 정보 조회
Last modified 3yr ago
계정 권한	회원 권한	계정 상태	회원 상태	계정 인증
`cash:read`	`role-cash:read`
Name	Type	Required	Allowed Operator [?]	Description
offset	`number`		eq	검색 시작 지점
limit	`number`		eq	한 페이지에 불러옥 목록 개수
startDate	`string`		eq	검색 날짜 시작 범위
endDate	`string`		eq	검색 날짜 끝 범위
type	`string`		eq	충전 및 차감 타입
groupId	`string`		eq	메시지 그룹 ID
rechargeMethod	`string`		eq	결제 수단 (STRIPE	ACCOUNT-TRANSFER)
serviceMethod	`string`		eq	사용 서비스 (MT)
balanceAmount	`number`		eq	사용 금액
balanceRecharge	`boolean`		eq	잔액 충전 여부
balanceDeduct	`boolean`		eq	잔액 차감 여부
pointRecharge	`boolean`		eq	포인트 충전 여부
pointDeduct	`boolean`		eq	포인트 차감 여부
잔액 변동내역 조회

Request

Authorization 인증 필요 [?]​

Query Params

Samples

getBalanceHistory.spec.js

Authorization 인증 필요 [?]
