잔액 변동내역 조회
GET https://api.coolsms.co.kr/cash/v1/balance/history
메시지 발송, 출금등으로 변동 된 잔액 내역을 조회합니다.
계정 권한 | 회원 권한 | 계정 상태 | 회원 상태 | 계정 인증 |
cash:read | role-cash:read | | | |
Name | Type | Required | 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 | 포인트 차감 여부 | |
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