API GUIDE

소개

이 가이드 문서는 x-ten API 연동 참조문서입니다. API 사용을 위해서는 아래와 같은 순서를 밡으셔야 합니다.

※ API 사용 순서
1. 회원가입 - 키 발급
2. 선불충전
3. 발신번호 등록
4. API 구축 및 테스트

※ API 구축 시 주의사항
- Header "content-Type" 확인
- Header "accept-Charset" 확인
- Header "method" 확인
- Parameter "text" 테스트 발송 시 사용
- Response content-Type: "application/json;charset=UTF-8"

공통 Header 내용을 확인해주시고, 질문사항이 있으시면 문의게시판을 이용해 주세요.

								# request header
								
content-Type {
	"application/x-www-form-urlencoded"
	"application/json"
	"multipart/form-data"
}
	
accept-Charset {
	"utf-8"
	"euc-kr"
}
	
method {
	"post"
}

# response header

content-Type {
	"application/json"
}		
accept-Charset {
	"utf-8"
}	
# request header

content-Type {
	"application/x-www-form-urlencoded"
	"application/json"
	"multipart/form-data"
}
	
accept-Charset {
	"utf-8"
	"euc-kr"
}
	
method {
	"post"
}

# response header

content-Type {
	"application/json"
}		
accept-Charset {
	"utf-8"
}
# request header

content-Type {
	"application/x-www-form-urlencoded"
	"application/json"
	"multipart/form-data"
}
	
accept-Charset {
	"utf-8"
	"euc-kr"
}
	
method {
	"post"
}

# response header

content-Type {
	"application/json"
}		
accept-Charset {
	"utf-8"
}	

							

발송 [전송방식 : POST]

메시지 발송은 SMS, LMS, MMS 가 존재합니다.
문자 타입은 문자 내용의 byte 및 이미지 파일 첨부로 결정됩니다.
SMS - 1byte ~ 90byte
LMS - 91byte ~ 4000byte
MMS - 이미지 파일 첨부시
발송 시 필수 파라메터 및 결과값, 에러코드는 아래 사항을 참고하세요.

URL - api.x-ten.co.kr/send/{uuid}

Request

[필수] String receiver
수신번호 [01012345678, 01011112222] ,(콤마)값으로 동보 발송 가능
[필수] String callerid
발신번호 - 등록된 발신번호만 사용가능 [발신번호 등록 참조]
[옵션] String subject
제목 - SMS에서는 필요 없음. null값일때 "제목없음"이 기본값
[필수] String msg
내용 - 한글이 2byte, 영문/특수문자 1byte
[옵션] String requestdate
전송일자 - [yyyyMMddhhmmss]년월일시분초 방식. null값일때 즉시발송
[옵션] String test
테스트여부 - 'Y' 값일때 테스트로 발송
[옵션] File file
첨부파일 - MMS 문자 발송일 경우에 첨부파일
[옵션] File file2
첨부파일 - MMS 문자 발송일 경우에 첨부파일2
[옵션] File file3
첨부파일 - MMS 문자 발송일 경우에 첨부파일3

Response

Int result_code
요청결과코드[해당 API 요청 결과] - 200 이외의 코드는 에러
String result_msg
결과메시지
String send_uuid
발송 요청시 보낸 uuid
String report_id
발송 결과 확인id [결과조회 참조]
Array report_id_list
수신번호에 ,(콤마)를 사용할때 다중결과 확인id
String send_msg_type
발송 타입 결과
Int msg_byte
발송 byte수 결과
String balance
발송 후 남은 잔액
Int request_success_count
발송 성공 수
Int request_error_count
발송 실패 수
boolean test
테스트 발송 여부

Result Code

100 content-type 이 맞지 않습니다.
101 uuid 가 존재하지 않습니다.
102 요청한 내용의 형식이 맞지 않습니다.
200 성공
301 receiver 파라메터가 없습니다.
302 callerid 파라메터가 없습니다.
303 msg 파라메터가 없습니다.
304 requestdate 형식이 맞지 않습니다. [yyymmddhhmmss 타입 또는 즉시 발송은 파라메터를 빈값으로 넣어주세요.]
400 발신번호가 등록되지 않았습니다.
500 잔액이 부족합니다.
600 파일 용량이 1메가가 넘습니다.
601 content-type 이 multipart/form-data 지만 파일이 없습니다.
800 요청이 잘못되었습니다. 관리자에게 문의하세요.
900 서버 에러. 관리자에게 문의하세요.
								# request sample
								
# org.springframework.web.client.RestTemplate
# Send_ResultVO = response 값으로 이루어진 VO
								
String url = "http://api.x-ten.co.kr/send/{your_uuid}";
RestTemplate restTemplate = new RestTemplate();

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);

MultiValueMap<String, Object>map = new MultiValueMap<String, Object>();
map.add("receiver", "01011112222,01022223333");
map.add("callerid", "01012345678");
map.add("msg", "헬로우 월드!.");
HttpEntity<MultiValueMap<String, Object>> request = new HttpEntity<MultiValueMap<String, Object>>(map, headers);

Send_ResultVO send_resultVO = restTemplate.postForObject(url, request, Send_ResultVO.class);
int result_code = send_resultVO.getResult_code();
...
... response process
...


# response sample
{
	"result_code": 200,
	"result_msg": "send ok",
	"send_uuid": "your_uuid",
	"report_id": null,
	"report_id_list":[
	"20181212000000030001",
	"20181212000000031001"
	],
	"send_msg_type": "SMS",
	"msg_byte": 13,
	"balance": "10,000.5",
	"request_success_count": 2,
	"request_error_count": 0,
	"test": false
}
# request sample

# exclude file
curl -i -X POST \
   -H "Accept-Charset:UTF-8" \
   -H "Content-Type:application/x-www-form-urlencoded" \
   -d "receiver=01011112222, 01022223333" \
   -d "callerid=01011112222" \
   -d "msg=헬로우 월드!." \
 'http://api.x-ten.co.kr/send/your_uuid'  

# include file 			
curl -i -X POST \
   -H "Accept-Charset:UTF-8" \
   -H "Content-Type:multipart/form-data" \
   -F "receiver=01011112222, 01022223333" \
   -F "callerid=01011112222" \
   -F "msg=헬로우 월드!." \
   -F "file=@\"./your_file\";type=image/jpeg;filename=\"your_file\"" \
 'http://api.x-ten.co.kr/send/your_uuid'

# response sample
{
	"result_code": 200,
	"result_msg": "send ok",
	"send_uuid": "your_uuid",
	"report_id": null,
	"report_id_list":[
	"20181212000000030001",
	"20181212000000031001"
	],
	"send_msg_type": "SMS",
	"msg_byte": 13,
	"balance": "10,000.5",
	"request_success_count": 2,
	"request_error_count": 0,
	"test": false
}
# request sample

<?
	$post_data = array(
		"receiver" => "01011112222, 01022223333",
		"callerid" => "01011112222",
		"msg" => "헬로우 월드!."
	);
	
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, http://api.x-ten.co.kr/send/your_uuid);
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
	$postResult = curl_exec($ch);
	...
	... response process
	...
?>

# response sample
{
	"result_code": 200,
	"result_msg": "send ok",
	"send_uuid": "your_uuid",
	"report_id": null,
	"report_id_list":[
	"20181212000000030001",
	"20181212000000031001"
	],
	"send_msg_type": "SMS",
	"msg_byte": 13,
	"balance": "10,000.5",
	"request_success_count": 2,
	"request_error_count": 0,
	"test": false
}

							

결과조회 [전송방식 : POST]

메시지 발송 후 반환되는 report_id로 결과를 조회할수 있습니다.

URL - api.x-ten.co.kr/report/{uuid}

Request

[필수] String report_id
조회 아이디

Response

Int result_code
결과코드 - 200 이외의 코드는 에러
String result_msg
결과메시지
Int report_result [전송결과표 참조]
전송결과코드[해당 발송 결과] - 100 이외의 코드는 에러
String uuid
발송 요청시 보낸 uuid
String msg_type
발송 타입 결과
String receiver
수신번호
String callerid
발신번호
String subject
발송 제목
String msg
발송 내용
Int msg_byte
발송 byte수 결과
String requestdate
발송 요청 일자
Int filecnt
발송 파일 개수

Result Code

100 content-type 이 맞지 않습니다.
101 uuid 가 존재하지 않습니다.
102 요청한 내용의 형식이 맞지 않습니다.
200 성공
300 report_id 파라메터가 없습니다.
301 report_id 길이가 작습니다.
800 요청이 잘못되었습니다. 관리자에게 문의하세요.
								# request sample
								
# org.springframework.web.client.RestTemplate
# Report_ResultVO = response 값으로 이루어진 VO
								
String url = "http://api.x-ten.co.kr/report/{your_uuid}";
RestTemplate restTemplate = new RestTemplate();

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);

MultiValueMap<String, Object>map = new MultiValueMap<String, Object>();
map.add("report_id", "20181212000000180001");
HttpEntity<MultiValueMap<String, Object>> request = new HttpEntity<MultiValueMap<String, Object>>(map, headers);

Report_ResultVO report_resultVO = restTemplate.postForObject(url, request, Report_ResultVO.class);
int result_code = report_resultVO.getResult_code();
...
... response process
...


# response sample
{
	"result_code": 200,
	"result_msg": "report ok",
	"uuid": "your_uuid",
	"report_id": "20181212000000180001",
	"msg_type": "LMS",
	"receiver": "01011112222",
	"callerid": "01011112222",
	"subject": "제목없음",
	"msg": "헬로우 월드!.",
	"msg_byte": 13,
	"requestdate": "2018-12-12 00:00:00.0",
	"filecnt": 0
}
# request sample

curl -i -X POST \
   -H "Accept-Charset:UTF-8" \
   -H "Content-Type:application/x-www-form-urlencoded" \
   -d "report_id=20181212000000180001" \
   -d "msg=헬로우 월드!." \
 'http://api.x-ten.co.kr/report/your_uuid'  

# response sample
{
	"result_code": 200,
	"result_msg": "report ok",
	"uuid": "your_uuid",
	"report_id": "20181212000000180001",
	"msg_type": "LMS",
	"receiver": "01011112222",
	"callerid": "01011112222",
	"subject": "제목없음",
	"msg": "헬로우 월드!.",
	"msg_byte": 13,
	"requestdate": "2018-12-12 00:00:00.0",
	"filecnt": 0
}
# request sample

<?
	$post_data = array(
		"report_id" => "20181212000000180001"
	);
	
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, http://api.x-ten.co.kr/report/your_uuid);
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
	$postResult = curl_exec($ch);
	...
	... response process
	...
?>

# response sample
{
	"result_code": 200,
	"result_msg": "report ok",
	"uuid": "your_uuid",
	"report_id": "20181212000000180001",
	"msg_type": "LMS",
	"receiver": "01011112222",
	"callerid": "01011112222",
	"subject": "제목없음",
	"msg": "헬로우 월드!.",
	"msg_byte": 13,
	"requestdate": "2018-12-12 00:00:00.0",
	"filecnt": 0
}

							

발신번호 등록 [전송방식 : POST]

메시지 발송 시에 사용되는 발신번호는 미리 등록한 뒤 사용해야합니다.
등록은 발신번호 등록과 인증 2단계로 이루어져있습니다.

1. 발신번호 등록 : callerid 를 파라메터로 보내서 등록
2. 인증번호 인증 : callerid 와 auth_number 를 파라메터로 보내서 인증

발송 시 필수 파라메터 및 결과값, 에러코드는 아래 사항을 참고하세요.

URL - api.x-ten.co.kr/callerid/reg/{uuid}

Request

[필수] String caller_id
발신번호
[필수] String auth_number
발신번호 인증번호

Response

Int result_code
결과코드 - 200 이외의 코드는 에러
String result_msg
결과메시지
String uuid
발송 요청시 보낸 uuid
String callerid
등록 할 발신번호

Result Code

100 content-type 이 맞지 않습니다.
101 uuid 가 존재하지 않습니다.
102 요청한 내용의 형식이 맞지 않습니다.
200 성공
300 발신번호 파라메터가 없습니다.
301 발신번호 형식이 맞지 않습니다.
302 이미 등록된 발신번호입니다.
303 번호는 등록되어있으나 인증이 되지 않았습니다.
400 같은 발신번호가 너무 많습니다. 관리자에게 문의하세요.
500 인증번호가 맞지 않습니다.
600 문자 발송이 되지 않습니다.
800 요청이 잘못되었습니다. 관리자에게 문의하세요.
								# request sample
								
# org.springframework.web.client.RestTemplate
# Callerid_Reg_ResultVO = response 값으로 이루어진 VO
								
String url = "http://api.x-ten.co.kr/callerid/reg/{your_uuid}";
RestTemplate restTemplate = new RestTemplate();

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);

MultiValueMap<String, Object>map = new MultiValueMap<String, Object>();
map.add("callerid", "01012345678");
map.add("auth_number", "1234");
HttpEntity<MultiValueMap<String, Object>> request = new HttpEntity<MultiValueMap<String, Object>>(map, headers);

Callerid_Reg_ResultVO callerid_Reg_ResultVO = restTemplate.postForObject(url, request, Callerid_Reg_ResultVO.class);
int result_code = callerid_Reg_ResultVO.getResult_code();
...
... response process
...


# response sample
{
	"result_code": 200,
	
	/* 발신번호 등록 완료 시  */
	"result_msg": "agree_number send ok",
	/* 발신번호 인증 완료 시  */
	"result_msg": "callerid regist ok",
	 
	"uuid": "your_uuid",
	"callerid": "01012345678"
}
# request sample

curl -i -X POST \
   -H "Accept-Charset:UTF-8" \
   -H "Content-Type:application/x-www-form-urlencoded" \
   -d "callerid=01012345678" \
   -d "auth_number=1234" \
 'http://api.x-ten.co.kr/callerid/reg/your_uuid'  

# response sample
{
	"result_code": 200,
	
	/* 발신번호 등록 완료 시  */
	"result_msg": "agree_number send ok",
	/* 발신번호 인증 완료 시  */
	"result_msg": "callerid regist ok",
	 
	"uuid": "your_uuid",
	"callerid": "01012345678"
}
# request sample

<?
	$post_data = array(
		"callerid" => "01012345678",
		"auth_number" => "1234"
	);
	
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, http://api.x-ten.co.kr/callerid/reg/your_uuid);
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
	$postResult = curl_exec($ch);
	...
	... response process
	...
?>

# response sample
{
	"result_code": 200,
	
	/* 발신번호 등록 완료 시  */
	"result_msg": "agree_number send ok",
	/* 발신번호 인증 완료 시  */
	"result_msg": "callerid regist ok",
	 
	"uuid": "your_uuid",
	"callerid": "01012345678"
}

							

발신번호 조회 [전송방식 : POST]

등록된 발신번호 내용을 확인할 수 있습니다.
발송 시 필수 파라메터 및 결과값, 에러코드는 아래 사항을 참고하세요.

URL - api.x-ten.co.kr/callerid/list/{uuid}

Request

[옵션] String caller_id
발신번호

Response

Int result_code
결과코드 - 200 이외의 코드는 에러
String result_msg
결과메시지
String uuid
발송 요청시 보낸 uuid
String search_callerid
검색 요청한 발신번호
Int calleridCnt
검색 결과 개수
Array callerid_list
검색 요청한 발신번호
String caller_id
검색된 발신번호
String use_yn
발신번호 사용 여부
String rep_yn
발신번호 대표번호 여부
String reg_date
발신번호 등록일자

Result Code

100 content-type 이 맞지 않습니다.
101 uuid 가 존재하지 않습니다.
102 요청한 내용의 형식이 맞지 않습니다.
200 성공
800 요청이 잘못되었습니다. 관리자에게 문의하세요.
								# request sample
								
# org.springframework.web.client.RestTemplate
# Callerid_List_ResultVO = response 값으로 이루어진 VO
								
String url = "http://api.x-ten.co.kr/callerid/list/{your_uuid}";
RestTemplate restTemplate = new RestTemplate();

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);

MultiValueMap<String, Object>map = new MultiValueMap<String, Object>();
map.add("callerid", "01012345678");
HttpEntity<MultiValueMap<String, Object>> request = new HttpEntity<MultiValueMap<String, Object>>(map, headers);

Callerid_List_ResultVO callerid_List_ResultVO = restTemplate.postForObject(url, request, Callerid_List_ResultVO.class);
int result_code = callerid_List_ResultVO.getResult_code();
...
... response process
...


# response sample
{
	"result_code": 200,
	"result_msg": "callerid list ok",
	"uuid": "your_uuid",
	"search_callerid": "01012345678",
	"calleridCnt": "1",
	"callerid_list":[
		{"caller_id": "01012345678", "use_yn": "Y", "rep_yn": "N", "reg_date": "2018-12-12 00:00:00"}
	]
}
# request sample

curl -i -X POST \
   -H "Accept-Charset:UTF-8" \
   -H "Content-Type:application/x-www-form-urlencoded" \
   -d "callerid=01012345678" \
 'http://api.x-ten.co.kr/callerid/list/your_uuid'  

# response sample
{
	"result_code": 200,
	"result_msg": "callerid list ok",
	"uuid": "your_uuid",
	"search_callerid": "01012345678",
	"calleridCnt": "1",
	"callerid_list":[
		{"caller_id": "01012345678", "use_yn": "Y", "rep_yn": "N", "reg_date": "2018-12-12 00:00:00"}
	]
}
# request sample

<?
	$post_data = array(
		"callerid" => "01012345678"
	);
	
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, http://api.x-ten.co.kr/callerid/list/your_uuid);
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
	$postResult = curl_exec($ch);
	...
	... response process
	...
?>

# response sample
{
	"result_code": 200,
	"result_msg": "callerid list ok",
	"uuid": "your_uuid",
	"search_callerid": "01012345678",
	"calleridCnt": "1",
	"callerid_list":[
		{"caller_id": "01012345678", "use_yn": "Y", "rep_yn": "N", "reg_date": "2018-12-12 00:00:00"}
	]
}

							

충전금 조회 [전송방식 : POST]

충전금을 조회 할 수 있습니다.
발송 시 필수 파라메터 및 결과값, 에러코드는 아래 사항을 참고하세요.

URL - api.x-ten.co.kr/charge/{uuid}

Request

[옵션] String charge_date
충전일자

Response

Int result_code
결과코드 - 200 이외의 코드는 에러
String result_msg
결과메시지
String uuid
발송 요청시 보낸 uuid
String search_date
검색 요청한 충전일자
Int chargeListCnt
검색 결과 개수
Array chargeList
검색 결과
String charge_date
충전일시 [yyyy-MM-dd]
String charge_amount
충전금액
String charge_type
충전 종류 [계좌이체, 신용카드 등]
String reg_date
충전일자

Result Code

100 content-type 이 맞지 않습니다.
101 uuid 가 존재하지 않습니다.
102 요청한 내용의 형식이 맞지 않습니다.
200 성공
300 charge_date 형식이 날자가 아닙니다.
800 요청이 잘못되었습니다. 관리자에게 문의하세요.
								# request sample
								
# org.springframework.web.client.RestTemplate
# Charge_ResultVO = response 값으로 이루어진 VO
								
String url = "http://api.x-ten.co.kr/charge/{your_uuid}";
RestTemplate restTemplate = new RestTemplate();

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);

MultiValueMap<String, Object>map = new MultiValueMap<String, Object>();
map.add("charge_date", "2018-12-12");
HttpEntity<MultiValueMap<String, Object>> request = new HttpEntity<MultiValueMap<String, Object>>(map, headers);

Charge_ResultVO charge_ResultVO = restTemplate.postForObject(url, request, Charge_ResultVO.class);
int result_code = charge_ResultVO.getResult_code();
...
... response process
...


# response sample
{
	"result_code": 200,
	"result_msg": "charge ok",
	"uuid": "your_uud",
	"search_date": "20181212",
	"chargeListCnt": 1,
	"chargeList":[
		{"charge_date": "2018-12-12", "charge_amount": "15,000", "charge_type": "신용카드", "reg_date": "2018-12-12 00:00:00"}
	]
}
# request sample

curl -i -X POST \
   -H "Accept-Charset:UTF-8" \
   -H "Content-Type:application/x-www-form-urlencoded" \
   -d "charge_date=2018-12-12" \
 'http://api.x-ten.co.kr/charge/your_uuid'  

# response sample
{
	"result_code": 200,
	"result_msg": "charge ok",
	"uuid": "your_uud",
	"search_date": "20181212",
	"chargeListCnt": 1,
	"chargeList":[
		{"charge_date": "2018-12-12", "charge_amount": "15,000", "charge_type": "신용카드", "reg_date": "2018-12-12 00:00:00"}
	]
}
# request sample

<?
	$post_data = array(
		"charge_date" => "2018-12-12"
	);
	
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, http://api.x-ten.co.kr/charge/your_uuid);
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
	$postResult = curl_exec($ch);
	...
	... response process
	...
?>

# response sample
{
	"result_code": 200,
	"result_msg": "charge ok",
	"uuid": "your_uud",
	"search_date": "20181212",
	"chargeListCnt": 1,
	"chargeList":[
		{"charge_date": "2018-12-12", "charge_amount": "15,000", "charge_type": "신용카드", "reg_date": "2018-12-12 00:00:00"}
	]
}

							

잔액 조회 [전송방식 : POST]

남은 잔액을 조회 할 수 있습니다.
발송 시 필수 파라메터 및 결과값, 에러코드는 아래 사항을 참고하세요.

URL - api.x-ten.co.kr/balance/{uuid}

Request

[옵션] String balance_date
잔액일자[yyyy-MM]

Response

Int result_code
결과코드 - 200 이외의 코드는 에러
String result_msg
결과메시지
String uuid
발송 요청시 보낸 uuid
String search_date
검색 요청한 잔액일자
String balance
잔액
String sms
잔액으로 발송 할수 있는 sms건수
String lms
잔액으로 발송 할수 있는 lms건수
String mms
잔액으로 발송 할수 있는 mms건수

Result Code

100 content-type 이 맞지 않습니다.
101 uuid 가 존재하지 않습니다.
102 요청한 내용의 형식이 맞지 않습니다.
200 성공
300 balance_date 형식이 날자가 아닙니다.[yyyy-MM]
800 요청이 잘못되었습니다. 관리자에게 문의하세요.
								# request sample
								
# org.springframework.web.client.RestTemplate
# Balance_ResultVO = response 값으로 이루어진 VO
								
String url = "http://api.x-ten.co.kr/balance/{your_uuid}";
RestTemplate restTemplate = new RestTemplate();

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);

MultiValueMap<String, Object>map = new MultiValueMap<String, Object>();
map.add("balance_date", "2018-10");
HttpEntity<MultiValueMap<String, Object>> request = new HttpEntity<MultiValueMap<String, Object>>(map, headers);

Balance_ResultVO balance_ResultVO = restTemplate.postForObject(url, request, Balance_ResultVO.class);
int result_code = balance_ResultVO.getResult_code();
...
... response process
...


# response sample
{
	"result_code": 200,
	"result_msg": "balance ok",
	"uuid": "your_uuuid",
	"search_date": "201810",
	"balance": "78.4",
	"sms": "7",
	"lms": "2",
	"mms": "0"
}
# request sample

curl -i -X POST \
   -H "Accept-Charset:UTF-8" \
   -H "Content-Type:application/x-www-form-urlencoded" \
   -d "balance_date=2018-10" \
 'http://api.x-ten.co.kr/balance/your_uuid'  

# response sample
{
	"result_code": 200,
	"result_msg": "balance ok",
	"uuid": "your_uuuid",
	"search_date": "201810",
	"balance": "78.4",
	"sms": "7",
	"lms": "2",
	"mms": "0"
}
# request sample

<?
	$post_data = array(
		"balance_date" => "2018-10"
	);
	
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, http://api.x-ten.co.kr/balance/your_uuid);
	curl_setopt($ch, CURLOPT_POST, 1);
	curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
	$postResult = curl_exec($ch);
	...
	... response process
	...
?>

# response sample
{
	"result_code": 200,
	"result_msg": "balance ok",
	"uuid": "your_uuuid",
	"search_date": "201810",
	"balance": "78.4",
	"sms": "7",
	"lms": "2",
	"mms": "0"
}