/

API 규격서 v0.6.2

서울시 통합 관제 API 규격서(안)

Version 0.6.2

2018-10-04

목차

1.	History	5

2.	Overview	6

2.1	Document Version	6

2.2	Terms	6

3.	API Model	7

3.1	Protocol (로컬 ↔ 센터)	7

3.2	Protocol (기기 → 로컬서버)	7

3.3	Protocol (기기 ← 로컬서버)	7

3.4	HTTP Header	8

3.5	HTTP Body	8

3.5.1	HTTP Request Body	8

3.5.2	HTTP Response Body	8

3.5.3	TCP/IP 전문 규격	9

3.5.4	TCP/IP JSON 규격	9

3.6	JSON Definition	9

3.7	URI Naming Rule	9

3.8	이미지 전송	10

3.9	프로토콜 보안	10

4.	Definition of APIs	11

4.1	주차장 차단기	11

4.1.1	차단기 상태 정보 (로컬 ® 센터)	11

4.1.2	차단기 상태 정보 (기기 ® 로컬)	13

4.1.3	LPR 상태 정보 (로컬 ® 센터)	13

4.1.4	LPR 상태 정보 (기기 ® 로컬)	15

4.1.5	사전 정산기 상태 정보 (로컬 ® 센터)	15

4.1.6	사전 정산기 상태 정보 (기기® 로컬)	16

4.1.7	사전정산기 영수증프린터 상태 정보 (로컬 ® 센터)	18

4.1.8	사전정산기 영수증프린터 상태 정보 (기기 ® 로컬)	19

4.1.9	사전 정산기 동글이 상태 정보 (로컬 ® 센터)	19

4.1.10	사전 정산기 동글이 상태 정보 (기기 ® 로컬)	20

4.1.11	사전 정산기 IC카드단말기 상태 정보 (로컬 ® 센터)	22

4.1.12	사전 정산기 IC카드단말기 상태 정보 (기기 ® 로컬)	22

4.1.13	출구 정산기 상태 정보 (로컬 ® 센터)	24

4.1.14	출구 정산기 상태 정보 (기기 ® 로컬)	24

4.1.15	출구 정산기 영수증프린터 상태 정보 (로컬 ® 센터)	25

4.1.16	출구 정산기 영수증프린터 상태 정보 (기기 ® 로컬)	26

4.1.17	출구 정산기 동글이 상태 정보 (로컬 ® 센터)	27

4.1.18	출구정산기 동글이 상태 정보 (기기 ® 로컬)	28

4.1.19	출구 정산기 IC카드단말기 상태 정보 (로컬 ® 센터)	29

4.1.20	출구 정산기 IC카드단말기 상태 정보 (기기 ® 로컬)	29

4.1.21	차단기 제어 (센터 ® 로컬)	30

4.1.22	차단기 제어 (로컬 ® 기기)	31

4.1.23	만차 차단기 제어 (로컬 ® 기기)	33

4.1.24	입차 처리 (로컬 ® 센터)	36

4.1.25	입차 처리 (기기 ® 로컬)	37

4.1.26	자동감면 확인결과 전달 (기기 ® 로컬)	39

4.1.27	자동감면 확인결과 전달 (로컬 ® 센터)	39

4.1.28	자동감면(즉시감면서비스연계) (로컬 ® 센터)	40

4.1.29	자동감면 이력전달 (자동감면 일일 데이터 배포) (센터 ® 로컬)	42

4.1.30	출차정산기 환승요청(기기 ® 로컬)	43

4.1.31	환승정보 전달(센터 ® 로컬)	43

4.1.32	환승정보 전달(로컬 ® 센터)	44

4.1.33	사전정산기 요금확인 (기기 ® 로컬)	45

4.1.34	출구정산기 요금확인 (기기 ® 로컬)	47

4.1.35	출구 정산기 할인권 리딩 (기기 ® 로컬)	48

4.1.36	요일제참여확인 (로컬 센터)	49

4.1.37	LPR 재기동 (센터 ® 로컬)	50

4.1.38	LPR 재기동 (로컬 ® 기기)	52

4.1.39	전광판 문구 표시 (로컬 ® 기기)	54

4.1.40	출구정산기 요금 표출 (로컬 ® 기기)	55

4.1.41	출구정산기 요금 표출 (센터 ® 로컬)	57

4.1.42	출구정산기 영수증 출력 (로컬 ® 기기)	59

4.1.43	출구정산기 영수증 출력 (센터 ® 로컬)	60

4.1.44	주차 정보 수정 [차량번호] (로컬 ® 센터)	62

4.1.45	주차 정보 수정 [차량번호] (센터 ® 로컬)	62

4.1.46	할인등록정보전달 (로컬 ® 기기)	64

4.1.47	할인등록정보전달 (로컬 ® 센터)	65

4.1.48	수동 할인 적용 (로컬 ® 기기)	66

4.1.49	수동 할인 적용 (센터 ® 로컬)	68

4.1.50	수동 할인 삭제	70

4.1.51	출구정산기 요금 표출(미인식) (센터 ® 로컬)	71

4.1.52	결제정보전달 (기기 ® 로컬)	72

4.1.53	결제정보전달 (로컬 ® 센터)	74

4.1.54	미납정보전달 (로컬 ® 센터)	77

4.1.55	미납목록조회 (로컬 ® 센터)	79

4.1.56	미납결제정보전송 (로컬 ® 센터)	80

4.1.57	출구정산기 재기동 (로컬 ® 기기)	81

4.1.58	출구정산기 재기동 (센터 ® 로컬)	83

4.1.59	사전정산기 재기동 (로컬 ® 기기)	86

4.1.60	사전정산기 재기동 (센터 ® 로컬)	87

4.1.61	입구안내전광판갱신 (주차카운트변경) (로컬 ® 기기)	90

4.1.62	입구안내전광판갱신 (주차카운트변경) (센터 ® 로컬)	91

4.1.63	사전등록확인 (로컬 센터)	93

4.1.64	사전정산기 요금 표출 (센터 ® 로컬)	94

4.1.65	사전정산기 영수증 출력 (로컬 ® 기기)	95

4.1.66	사전정산기 영수증 출력 (센터 ® 로컬)	96

4.1.67	출차 정보 전달 (기기 ® 로컬)	98

4.1.68	출차 정보 전달 (로컬 ® 센터)	99

4.1.69	주차 요금결제정보 전달 (기기 ® 로컬)	101

4.1.70	주차 요금결제정보 전달 (로컬 ® 기기)	103

4.1.71	주차 요금 결제정보 저장 (로컬 ® 로컬)	105

4.1.72	주차 요금 결제정보 전달 (로컬 ® 센터)	107

4.1.73	결제 취소 정보 전달 [로컬 취소] (로컬 ® 센터)	110

4.1.74	결제 취소 정보 전달 [로컬 취소] (센터 ® 로컬)	112

4.1.75	수동 입차 처리 (로컬 ® 센터)	114

4.1.76	수동 입차 처리 (센터 ® 로컬)	115

4.1.77	수동 출차 처리 (로컬 ® 센터)	116

4.1.78	수동 출차 처리 (센터 ® 로컬)	117

4.1.79	요금제 등록/수정 (센터 ® 로컬)	118

4.1.80	주차장 정보 등록/수정 (센터 ® 로컬)	122

4.1.81	월정기권 상품정보 전송 (센터 ® 로컬)	125

4.1.82	월정기권 주차장 이관 (센터 ® 로컬)	126

4.1.83	월정기권 결제정보 전송 (로컬 ® 센터)	127

4.1.84	무료정기권 전송 (센터 ® 로컬)	128

4.1.85	장비목록 (로컬 ® 센터)	130

4.1.86	장비목록 (센터 ® 로컬)	131

5.	개발 가이드	133

5.1	연동 및 권고 사항	133

5.2	API 구현	133

5.3	서버 정보	133

6.	참고	134

6.1	사용 코드	134

6.2	응답 코드	134

History

Version	Date	Contents
0.0.1	2018-08-08	[최초]
0.5.0	2018-08-30	다래파크텍 수정 제안 - API 작성 - HTTP 국제 표준 수용 (HTTPS, multipart/form-data, content-disposition)
0.5.1	2018-09-02	파킹클라우드 수정 제안 - 미납정보전송 추가 - 미납목록조회 추가 - 미납결제정보전송 추가 - 월정기권 상품정보 전송 추가 - 월정기권 주차장 이관 파라미터 추가 - 월정기권 결제정보 전송 추가 - 무료정기권 전송 추가
0.6.1	2018-09-26	파킹클라우드 수정 제안 - 기기 ↔ 로컬 간 프로토콜 초안 정의
0.6.2	2018-10-04	파킹클라우드 프로토콜 - 2018-10-01 리뷰 회의 후 프로토콜 추가

Overview

본 문서는 주차장 로컬 과 관제 서버 간 통신 API에 대해 기술한다.

Document Version

문서의 버전은 3개 영역으로 나뉘며, 각 자리의 의미는 다음과 같으며 빌드 버전은 사용하지 않는다.

- 첫째 자리: Major 버전(전문 규격서 Major 변경 시)

- 둘째 자리: Minor 버전(전문 규격서 Minor 변경 시)

- 셋째 자리: Patch 버전(시스템 변경 없이 프로세스, 코드 및 내용 추가/변경 시)

Terms

Term	Abbreviation	Description

API Model

Protocol (로컬 ↔ 센터)

본 인터페이스는 HTTP POST 및 GET 방식을 사용하며, Request/Response 시 JSON 타입으로 데이터를 송수신한다.

Protocol (기기 → 로컬서버)

본 인터페이스는 HTTP POST 및 GET 방식을 사용하며, Request/Response 시 JSON 타입으로 데이터를 송수신한다.

Protocol (기기 ← 로컬서버)

본 인터페이스는 TCP/IP 방식을 사용하며, Request/Response시 JSON String Size(8byte) + JSON 타입으로 전문 데이터를 송수신한다.

HTTP Header

HTTP Header Field	Description	Required
Content-Type	HTTP Header의 Content-Type과 Accept 속성에 “application/json”을 지정하여야 한다(아래 예제 참고) Content-Type: application/json; Accept: application/json; 단 이미지 전송 시에는 "multipart/form-data"를 사용한다. Content-Type: multipart/form-data	Y

IETF (Internet Engineering Task Force: 국제 인터넷 표준화 기구)에서 정의한 표준 HTTP header를 사용한다.

HTTP Body

Request/Response의 HTTP Body는 JSON 타입으로 구성된다.

HTTP Request Body

Key	Type	Length	Required	Description
park_seq	String	가변	Y	주차장 일련번호
equipment_ip	String	가변	Y	장치 IP
equipment_name	String	가변	Y	장치 명 ( ex I01: 입구차단기01 , O01: 출구차단기01 )
way	String	가변	Y	개폐 방법 ( ex OPEN:열기, CLOSE: 닫기 )

{

"park_seq":"0001"

, " equipment_ip":"192.168.0.1"

, " equipment_name":"I01"

, " way ":"CLOSE"

}

HTTP Response Body

Key	Type	Length	Required	Description
result주1)	String	4	Y	Response Code(0000: Success)
resutlMessage	String	가변	Y	Result Message

주1) 7.2의 응답 코드 참고

{

"result":"0000"

, "resultMessage":"정상처리"

}

TCP/IP 전문 규격

8byte JSON String 패킷 크기 String + JSON String

패킷 크기(8byte ASCII): 패킷 크기(8byte)를 제외한 패킷 전문 총 크기

ex) 00000156{"head":{"pversion":"20180919","sourceid":"P01","targetid":"M01", "command":"PaymentAmount","transtype":"REQUEST","result":0},"body":{"carno":"11가1111"}}

TCP/IP JSON 규격

Key

Type

Length

Required

Description

head

JSON Object

가변

Y

공통 JSON

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

JSON Object

가변

Y

요청 종류별(command) JSON 정의

JSON Definition

[Key / Value 조합]

- 입력, 수정을 하려는 속성은 반드시 Key / Value 조합으로 구성을 하여야 한다.

- 만약 Key가 없으면 입력, 수정 시 대상에서 제외된다.

URI Naming Rule

서버의 URI들은 아래와 같은 형식으로 표현한다.

테스트	http://[Domain or IP]:[Port]/[Service Name]/[API ID]
상용	https://[Domain or IP]:[Port]/[Service Name]/[API ID]

Attribute	Description	Example
Domain or IP	서버의 Domain 또는 IP	parkapi.seoul.co.kr
Port	서버의 Port	443
Service Name	해당 서비스 이름	Cs
API ID	해당 API의 ID	inout/gate

예) 주차장 차단기 제어 요청을 할 경우의 URI는 아래와 같다.

http://parkapi.seoul.co.kr:8080/inout/gate è 테스트

https://parkapi.seoul.co.kr:443/inout/gate è 상용

이미지 전송

이미지 업로드는 IETF 국제 표준 규격인 RFC 1867을 준수하여 multipart/form-data로 전송한다.

입차 및 출차 이미지의 name 필드는 "images"로 통일한다.

Content-type: multipart/form-data, boundary=AaB03x

--AaB03x

content-disposition: form-data; name="images"

... 이미지 stream을 직접 전송하는 경우 ...

--AaB03x

content-disposition: form-data; name="images"; filename="image1.jpg"

Content-Type: text/plain

... 파일로부터 전송하는 경우 ...

--AaB03x--

이미지 다운로드는 IETF 국제 표준 규격인 RFC 2183을 준수하여 content-disponsition 헤더로 전송한다.

Content-type: application/octet-stream

Content-Disposition: attachment; filename="image1.jpg"

… 이미지 stream …

프로토콜 보안

프로토콜 보안은 IETF 국제 표준 규격인 RFC 2818을 준수하여 HTTPS로 전송한다. HTTPS는 메시지 안전성을 보장하므로 message body에 대한 별도의 encryption/decryption은 필요하지 않다.

Definition of APIs

주차장 차단기

차단기 상태 정보 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/inout/status/bar
Request
Key	Key Name	Type	Length	Required	Description
park_id	주차장 식별ID	String	가변	Y
equipment_list	차단기리스트	Json array	가변
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y
equipment_name	장치 명	String	가변	Y	I01:입구01
active_status	장비동작상태	String	가변	Y	TRUE: 정상 , FALSE: 에러 (errmsg에 상세내용 텍스트로 표기
add_status	부가 상태정보	String	가변		- 차단기 부가 상태정보 UP : 열림, DOWN : 닫힘 UPLOCK : 열림잠금 DOWNLOCK : 닫힘잠금.
errmsg	오류메시지	String	가변		장비오류 메시지
Data 예시
{ "park_seq":"0001" "equipment_list":[ { "equipment_name":"LI01", " active_status ":: “TRUE”, ”add_status”:”UP”, "equipment_ip":"127.0.0.1" }, { "equipment_name":"LO01", " active_status":: “TRUE”, ”add_status”:”UP”, "equipment_ip":"127.0.0.2" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

차단기 상태 정보 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/inout/status/bar
Request
Key	Key Name	Type	Length	Required	Description
equipment_ip	장치 IP	String	가변	Y
equipment_name	장치 명	String	가변	Y	I01:입구01
active_status	장비동작상태	String	가변	Y	TRUE: 정상 , FALSE: 에러 (errmsg에 상세내용 텍스트로 표기
add_status	부가 상태정보	String	가변		- 차단기 부가 상태정보 UP : 열림, DOWN : 닫힘 UPLOCK : 열림잠금 DOWNLOCK : 닫힘잠금.
errmsg	오류메시지	String	가변		장비오류 메시지
Data 예시
{ "equipment_name":"LI01", " active_status ":: “TRUE”, ”add_status”:”UP”, "equipment_ip":"127.0.0.1" “errmsg”:”정상” }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

LPR 상태 정보 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/inout/lprStatus
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	LI01:입구LPR01, LO01:출구LPR01
equipment_status	장치 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ "park_seq":"0001", "equipment_list":[ { "equipment_name":"LI01", "equipment_status":"TRUE", "equipment_ip":"127.0.0.1" }, { "equipment_name":"LO01", "equipment_status":"FALSE", "equipment_ip":"127.0.0.2" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

LPR 상태 정보 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/inout/lprStatus
Request
Key	Key Name	Type	Length	Required	Description
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	LI01:입구LPR01, LO01:출구LPR01
equipment_status	장치 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ "equipment_name":"LI01", "equipment_status":"TRUE", "equipment_ip":"127.0.0.1" }
Response
result	응답코드	String	가변	Y	0000:정상처리, 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

사전 정산기 상태 정보 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/device/fareMachineStatus
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
equipment_status	장치 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ “park_seq”:”0001”, “equipment_list”:[ { “equipment_name”:”FM01”, “equipment_status”:”TRUE”, “equipment_ip”:”127.0.0.1” }, { “equipment_name”:”FM02”, “equipment_status”:”FALSE”, “equipment_ip”:”127.0.0.2” } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

사전 정산기 상태 정보 (기기® 로컬)

URI	http://[Domain or IP]:[Port]/device/fareMachineStatus
Request
Key	Key Name	Type	Length	Required	Description
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
equipment_status	장치 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ “equipment_name”:”FM01”, “equipment_status”:”TRUE”, “equipment_ip”:”127.0.0.1” }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

사전정산기 영수증프린터 상태 정보 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/device/ReceiptPrinterStatus
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
printer_status	프린터 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
receipt_status	영수증 용지 상태	String	가변	Y	TRUE: 정상, FALSE: 없음, WARNING: 부족
Data 예시
{ "park_seq":"0001", "equipment_list":[ { "equipment_name":"FM01", "receipt_status":"TRUE", "equipment_ip":"127.0.0.1", "printer_status":"TRUE" }, { "equipment_name":"FM02", "receipt_status":"TRUE", "equipment_ip":"127.0.0.2", "printer_status":"TRUE" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

사전정산기 영수증프린터 상태 정보 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/device/ReceiptPrinterStatus
Request
Key	Key Name	Type	Length	Required	Description
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
printer_status	프린터 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
receipt_status	영수증 용지 상태	String	가변	Y	TRUE: 정상, FALSE: 없음, WARNING: 부족
Data 예시
{ "equipment_name":"FM01", "receipt_status":"TRUE", "equipment_ip":"127.0.0.1", "printer_status":"TRUE" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

사전 정산기 동글이 상태 정보 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/device/donggleStatus
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
donggle_status	동글이 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ "park_seq":"0001", "equipment_list":[ { "equipment_name":"FM01", "donggle_status":"TRUE", "equipment_ip":"127.0.0.1" }, { "equipment_name":"FM02", "donggle_status":"TRUE", "equipment_ip":"127.0.0.2" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

사전 정산기 동글이 상태 정보 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/device/donggleStatus
Request
Key	Key Name	Type	Length	Required	Description
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
donggle_status	동글이 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ "equipment_name":"FM01", "donggle_status":"TRUE", "equipment_ip":"127.0.0.1" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

사전 정산기 IC카드단말기 상태 정보 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/device/ICStatus
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
IC_status	IC 카드단말기 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ "park_seq":"0001", "equipment_list":[ { "equipment_name":"FM01", "IC_status":"TRUE", "equipment_ip":"127.0.0.1" }, { "equipment_name":"FM02", "IC_status":"TRUE", "equipment_ip":"127.0.0.2" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

사전 정산기 IC카드단말기 상태 정보 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/device/ICStatus
Request
Key	Key Name	Type	Length	Required	Description
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
IC_status	IC 카드단말기 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ "equipment_name":"FM01", "IC_status":"TRUE", "equipment_ip":"127.0.0.1" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출구 정산기 상태 정보 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/out/fareMachineStatus
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:정산기01, FMO02:정산기02
equipment_status	장치 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ “park_seq”:”0001”, “equipment_list”:[ { “equipment_name”:”FMO01”, “equipment_status”:”TRUE”, “equipment_ip”:”127.0.0.1” }, { “equipment_name”:”FMO02”, “equipment_status”:”FALSE”, “equipment_ip”:”127.0.0.2” } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출구 정산기 상태 정보 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/out/fareMachineStatus
Request
Key	Key Name	Type	Length	Required	Description
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:정산기01, FMO02:정산기02
equipment_status	장치 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ “equipment_name”:”FMO01”, “equipment_status”:”TRUE”, “equipment_ip”:”127.0.0.1” }
Response
Result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출구 정산기 영수증프린터 상태 정보 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/out/ReceiptPrinterStatus
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:정산기01, FMO02:정산기02
printer_status	프린터 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
receipt_status	영수증 용지 상태	String	가변	Y	TRUE: 정상, FALSE: 없음, WARNING: 부족
Data 예시
{ "park_seq":"0001", "equipment_list":[ { "equipment_name":"FMO01", "receipt_status":"TRUE", "equipment_ip":"127.0.0.1", "printer_status":"TRUE" }, { "equipment_name":"FMO02", "receipt_status":"TRUE", "equipment_ip":"127.0.0.2", "printer_status":"TRUE" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출구 정산기 영수증프린터 상태 정보 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/out/ReceiptPrinterStatus
Request
Key	Key Name	Type	Length	Required	Description
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:정산기01, FMO02:정산기02
printer_status	프린터 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
receipt_status	영수증 용지 상태	String	가변	Y	TRUE: 정상, FALSE: 없음, WARNING: 부족
Data 예시
{ "equipment_name":"FMO01", "receipt_status":"TRUE", "equipment_ip":"127.0.0.1", "printer_status":"TRUE" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출구 정산기 동글이 상태 정보 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/device/donggleStatus
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:정산기01, FMO02:정산기02
donggle_status	동글이 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ "park_seq":"0001", "equipment_list":[ { "equipment_name":"FM01", "donggle_status":"TRUE", "equipment_ip":"127.0.0.1" }, { "equipment_name":"FM02", "donggle_status":"TRUE", "equipment_ip":"127.0.0.2" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출구정산기 동글이 상태 정보 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/device/donggleStatus
Request
Key	Key Name	Type	Length	Required	Description
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:정산기01, FMO02:정산기02
donggle_status	동글이 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ "equipment_name":"FM01", "donggle_status":"TRUE", "equipment_ip":"127.0.0.1" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출구 정산기 IC카드단말기 상태 정보 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/device/ICStatus
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:정산기01, FMO02:정산기02
IC_status	IC 카드단말기 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ "park_seq":"0001", "equipment_list":[ { "equipment_name":"FM01", "IC_status":"TRUE", "equipment_ip":"127.0.0.1" }, { "equipment_name":"FM02", "IC_status":"TRUE", "equipment_ip":"127.0.0.2" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출구 정산기 IC카드단말기 상태 정보 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/device/ICStatus
Request
Key	Key Name	Type	Length	Required	Description
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:정산기01, FMO02:정산기02
IC_status	IC 카드단말기 상태	String	가변	Y	TRUE: 정상, FALSE: 비정상
Data 예시
{ "equipment_name":"FM01", "IC_status":"TRUE", "equipment_ip":"127.0.0.1" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

차단기 제어 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/device/gateCtl
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_ip	장치 IP	String	가변	Y
equipment_name	장치 명	String	가변	Y	I01:입구01, O01:출구01
way	개폐 방법	String	가변	Y	OPEN:열기, CLOSE: 닫기
Data 예시
{ "park_seq":"0001" , " equipment_ip":"192.168.0.1" , " equipment_name":"I01" , " way ":"CLOSE" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

차단기 제어 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (BarCtl)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
way	String	가변	Y	OPEN:열기, CLOSE: 닫기
equipment_name	String	가변	Y	I01:입구01, O01:출구01

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"I01",

"command":"BarCtl",

"transtype":"REQUEST",

"result":”0”

},

"body":

{

"way”:”OPEN",

"equipment_name":"I01"

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (BarCtl)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
state	String	가변	Y	처리 후 상태 OPEN:열림, CLOSE: 닫힘
equipment_name	String	가변	Y	I01:입구01, O01:출구01

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"I01",

"targetid":"S01",

"command":"BarCtl",

"transtype":"RESPONSE",

"result":”0”

},

"body":

{

"state”:”OPEN",

"equipment_name":"I01"

}

}

만차 차단기 제어 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (BarCtl)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
way	String	가변	Y	OPEN:열기, CLOSE: 닫기
equipment_name	String	가변	Y	I01:입구01, O01:출구01

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"I01",

"command":"BarCtl",

"transtype":"REQUEST",

"result":”0”

},

"body":

{

"way”:”OPEN",

"equipment_name":"I01"

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (BarCtl)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
state	String	가변	Y	처리 후 상태 OPEN:열림, CLOSE: 닫힘
equipment_name	String	가변	Y	I01:입구01, O01:출구01

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"I01",

"targetid":"S01",

"command":"BarCtl",

"transtype":"RESPONSE",

"result":”0”

},

"body":

{

"state”:”OPEN",

"equipment_name":"I01"

}

}

입차 처리 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/svc/inout/carEnter
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
equipment_name	장치 명	String	가변	Y	I01:입구01
enter_datetime	입차 시간	String	가변	Y
car_no	차량 번호	String	가변	Y
enter_file_path	이미지 파일 경로	String	가변	Y	이미지 경로
enter_file_name	이미지 파일 이름	String	가변	Y	이미지 파일 이름
parking_type	주차종류	String	가변	Y	1: 월정기, 2:시간주차 ….
Data 예시
{ "equipment_name":"I01", "park_seq":"0001", "enter_file_name":"0001_I01_11가111_20180101000000.jpg", "local_key":"0001", "enter_file_path":"C:\\IMG\\IN\\20180101\\", "car_no":"11가1111", "enter_datetime":"20180101000000", "parking_type":"1" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	JsonObject	가변	Y
resultData JsonObject 상세
svr_key	서버주차일련번호	String	가변	Y
bill_reg_ny	사전 등록 여부	String	가변	Y	Y: 사전등록, N:미등록
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "result":"0000", "resultMessage":"정상처리", "resultData":{ "svr_key":"000001", "bill_reg_ny":"N", "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ] } }

입차 처리 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/inout/carEnter
Request
Key	Key Name	Type	Length	Required	Description
local_key	로컬주차일련번호	String	가변	Y
equipment_name	장치 명	String	가변	Y	I01:입구01
enter_datetime	입차 시간	String	가변	Y
car_no	차량 번호	String	가변	Y
enter_file_path	이미지 파일 경로	String	가변	Y	이미지 경로
enter_file_name	이미지 파일 이름	String	가변	Y	이미지 파일 이름
enter_image_base64	이미지 base64	String	가변	Y	이미지 Base64 stream
parking_type	주차종류	String	가변	Y	1: 월정기, 2:시간주차 ….
Data 예시
{ "equipment_name":"I01", "enter_file_name":"0001_I01_11가111_20180101000000.jpg", "local_key":"0001", "enter_file_path":"C:\\IMG\\IN\\20180101\\", "enter_image_base64":".....", "car_no":"11가1111", "enter_datetime":"20180101000000", "parking_type":"1" }
Response
Result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	JsonObject	가변	Y
Data 예시
{ "result":"0000", "resultMessage":"정상처리" }

자동감면 확인결과 전달 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/discount/apply
Ditection	기기 ® 로컬					14, 15, 16
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
Code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ], "svr_key":"0001", "local_key":"0001" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

자동감면 확인결과 전달 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/discount/apply
Ditection	로컬 ® 센터					14, 15, 16
Request
Key	Key Name	Type	Length	Required	Description
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "discount_info":[ { "code":"001", "type":"T", "value":"10" } ], "svr_key":"0001", "local_key":"0001" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

자동감면(즉시감면서비스연계) (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/external/immediate_discount
Ditection	로컬 -> 센터 (즉시감면 시스템 명세서 확인 후 추가 작성)_					14, 15, 16
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ “park_seq”:”00001”, "discount_info":[ { "code":"001", "type":"T", "value":"10" } ], "svr_key":"0001", "local_key":"0001" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

자동감면 이력전달 (자동감면 일일 데이터 배포) (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/external/immediate_discount/daily_sync
Ditection	로컬 <- 센터 (0시 이전일자 동기화 요청 함) 즉시감면 시스템 명세서 확인 후 추가 작성)_					17
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
immediate_discount_list
seq	일련번호	String	가변	Y
carno	차량번호	String	가변	Y
code	할인 코드	String	가변	Y	할인 구분 코드
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
name	할인 명	String	가변	Y	할인명
Data 예시
{ “parkseq”:”0001 “immediate_discount_list”:[ {" seq":"0001",”carno”:”12다1234” , “code”:”11111” , “TYPE”:”%”, “value”:”50”, “name”:”국가유공자”} ,{" seq":"0002",”carno”:”12다1111, “code”:”11111” , “TYPE”:”%”, “value”:”50”, “name”:”경차”} ,{" seq":"0003",”carno”:”12다2222” , “code”:”11111” , “TYPE”:”%”, “value”:”50”, “name”:”국가유공자”} ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출차정산기 환승요청(기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/discount/transfer_apply
Ditection	기기 ® 로컬					14, 15, 16
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ “park_seq”:”00001”, "discount_info":[ { "code":"001", "type":"T", "value":"10" } ], "svr_key":"0001", "local_key":"0001" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

환승정보 전달(센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/discount/transfer_get
Ditection	기기 ® 로컬					14, 15, 16
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
Data 예시
{ “park_seq”:”00001”, "svr_key":"0001", "local_key":"0001" }
Response
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ “park_seq”:”00001”, "discount_info":[ { "code":"001", "type":"T", "value":"10" } ], "svr_key":"0001", "local_key":"0001" }

환승정보 전달(로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/discount/transfer_apply
Ditection	기기 ® 로컬					14, 15, 16
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ “park_seq”:”00001”, "discount_info":[ { "code":"001", "type":"T", "value":"10" } ], "svr_key":"0001", "local_key":"0001" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

사전정산기 요금확인 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/fare/calculationByCarnoFourCipher
Ditection	기기 ® 로컬					14, 15, 16
Request
Key	Key Name	Type	Length	Required	Description
carno_four_cipher	차량번호 4 자리수	String	가변	Y
calc_end_time	정산종료시간	String	가변	Y
Data 예시
{ “carno_four_cipher”:”1111”, "calc_end_time":"2018-01-01 17:01:01" }
Response
fare_info JsonArray 상세
carno	차량번호	String	가변	Y
calc_start_time	정산시작시간	String	가변	Y
calc_end_time	정산종료시간	String	가변	Y
charge_price	부과금액	String	가변	Y
discount_price	할인금액	String	가변	Y
payment_price	결제금액	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
name	할인 명	String	가변	Y	할인 명
Data 예시
"fare_info":[ { "carno":"11가1111", "calc_start_time":"2018-01-01 00:00:00", "calc_end_time":"2018-01-01 17:01:01", "charge_price":"5000", "discount_price":"2000", "payment_price":"3000", "discount_info":[ { "code":"001", "kind":"G", "type":"P", "value":"2000", "name":"2000원할인" } ] } ]

출구정산기 요금확인 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/fare/calculationByCarno
Ditection	기기 ® 로컬					14, 15, 16
Request
Key	Key Name	Type	Length	Required	Description
carno	차량번호	String	가변	Y
calc_end_time	정산종료시간	String	가변	Y
Data 예시
{ “carno”:”11가1111”, "calc_end_time":"2018-01-01 17:01:01" }
Response
carno	차량번호	String	가변	Y
calc_start_time	정산시작시간	String	가변	Y
calc_end_time	정산종료시간	String	가변	Y
charge_price	부과금액	String	가변	Y
discount_price	할인금액	String	가변	Y
payment_price	결제금액	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
name	할인 명	String	가변	Y	할인 명
Data 예시
{ "carno":"11가1111", "calc_start_time":"2018-01-01 00:00:00", "calc_end_time":"2018-01-01 17:01:01", "charge_price":"5000", "discount_price":"2000", "payment_price":"3000", "discount_info":[ { "code":"001", "kind":"G", "type":"P", "value":"2000", "name":"2000원할인" } ] }

출구 정산기 할인권 리딩 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/discount/coupon_apply
Ditection	기기 ® 로컬					14, 15, 16
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ “park_seq”:”00001”, "discount_info":[ { "code":"001", "type":"T", "value":"10" } ], "svr_key":"0001", "local_key":"0001" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

요일제참여확인 (로컬 센터)

URI	http://[Domain or IP]:[Port]/external/yoilje
Ditection	로컬 -> 센터 (즉시감면 시스템 명세서 확인 후 추가 작성)_					23, 24
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_ip	장치 IP	String	가변	Y
equipment_name	장치 명	String	가변	Y	I01:입구01
carno	차량번호	String	가변	Y	차량번호
Data 예시
{ "park_seq":"0001" , " equipment_ip":"192.168.0.1" , " equipment_name":"I01" , " carno":"12라1234" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
resultData	감면상세정보	JsonObject	가변	Y	즉시감면시스템 명세서 확인 후 조정
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" , "resultData":{ " carno:"12라1234”” ,”dayoftheweek”:”1” } }

LPR 재기동 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/inout/lprRestart
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	LI01:입구LPR01, LO01:출구LPR01
Data 예시
{ "park_seq":"0001", "equipment_list":[ { "equipment_name":"LI01", "equipment_ip":"127.0.0.1" }, { "equipment_name":"LO01", "equipment_ip":"127.0.0.2" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	String	가변	Y
resultData JsonObject 상세
equipment_list	장비리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	LI01:입구LPR01, LO01:출구LPR01
restart_result	재기동 결과	String	가변	Y	0000: 정상처리, 그외: 오류
Data 예시
{ "result":"0000", "resultData":{ "equipment_list":[ { "equipment_name":"LI01", "restart_result":"0000", "equipment_ip":"127.0.0.1" }, { "equipment_name":"LO01", "restart_result":"0001", "equipment_ip":"127.0.0.2" } ] }, "resultMessage":"정상처리" }

LPR 재기동 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (LPRCtl)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
way	String	가변	Y	RESTART:재기동
equipment_name	String	가변	Y	L01:LPR01

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"L01",

"command":"LPRCtl",

"transtype":"REQUEST",

"result":”0”

},

"body":

{

"way”:”RESTART",

"equipment_name":"L01"

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (LPRCtl)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
state	String	가변	Y	처리 후 상태 NORMALITY:정상 ABNORMALITY:비정상
equipment_name	String	가변	Y	L01:LPR01

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"L01",

"targetid":"S01",

"command":" LPRCtl",

"transtype":"RESPONSE",

"result":”0”

},

"body":

{

"state”:”NORMALITY",

"equipment_name":"L01"

}

}

전광판 문구 표시 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (LedPlate)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
uppertext	String	가변	Y	상단문구
lowertext	String	가변	Y	하단문구
uppercolor	String	가변	Y	상단컬러 ("R","G","Y")
lowercolor	String	가변	Y	하단컬러 ("R","G","Y")
showtime	String	가변	Y	표시시간 (초)

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"LED01",

"command":" LedPlate",

"transtype":"REQUEST",

"result":”0”

},

"body":

{

" uppertext”:”11고1111",

" lowertext":"등록차량",

" uppercolor":"Y",

" lowercolor":"Y",

" showtime":"10"

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (LPRCtl)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"LED01",

"targetid":"S01",

"command":" LedPlate",

"transtype":"RESPONSE",

"result":”0”

}

}

출구정산기 요금 표출 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (FareDisplay)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
local_key	String	가변	Y	로컬 입차 키
svr_key	String	가변	Y	서버 입차 키

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"FM01",

"command":" FareDisplay",

"transtype":"REQUEST",

"result":”0”

},

"body":

{

" local_key”:”000001",

"svr_key":"000001"

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (FareDisplay)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"FM01",

"targetid":"S01",

"command":" FareDisplay",

"transtype":"RESPONSE",

"result":”0”

}

}

출구정산기 요금 표출 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/out/fare/display
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:출구정산기01, FMO02:출구정산기02
local_key	로컬 주차 일련번호	String	가변	Y
svr_key	서버 주차 일련번호	String	가변	Y
Data 예시
{ "equipment_name":"FMO01", "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "equipment_ip":"127.0.0.1" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{"result":"0000","resultMessage":"정상처리"}

출구정산기 영수증 출력 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (FarePrint)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
local_key	String	가변	Y	로컬 입차 키
svr_key	String	가변	Y	서버 입차 키

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"FMO01",

"command":" FarePrint",

"transtype":"REQUEST",

"result":”0”

},

"body":

{

" local_key”:”000001",

"svr_key":"000001"

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (FarePrint)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"FMO01",

"targetid":"S01",

"command":" FarePrint",

"transtype":"RESPONSE",

"result":”0”

}

}

출구정산기 영수증 출력 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/out/fare/print
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:출구정산기01, FMO02:출구정산기02
local_key	로컬 주차 일련번호	String	가변	Y
svr_key	서버 주차 일련번호	String	가변	Y
Data 예시
{ "equipment_name":"FMO01", "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "equipment_ip":"127.0.0.1" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{"result":"0000","resultMessage":"정상처리"}

주차 정보 수정 [차량번호] (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/inout/carnoUpdate
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
carno	차량 번호	String	가변	Y
local_key	로컬 주차 일련번호	String	가변	Y
svr_key	서버 주차 일련번호	String	가변	Y
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "carno":"11가1111" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{"result":"0000","resultMessage":"정상처리"}

주차 정보 수정 [차량번호] (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/inout/carnoUpdate
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
carno	차량 번호	String	가변	Y
local_key	로컬 주차 일련번호	String	가변	Y
svr_key	서버 주차 일련번호	String	가변	Y
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "carno":"11가1111" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{"result":"0000","resultMessage":"정상처리"}

할인등록정보전달 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

Head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (DISCOUNTAPPLY)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

Body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
code	String	가변	Y	할인 구분 코드
kind	String	가변	Y	G:일반, R:감면
type	String	가변	Y	T:시간(분), P:금액, %:퍼센트	T:시간(분), P:금액, %:퍼센트
value	String	가변	Y	시간(분) 또는 금액 또는 %	시간(분) 또는 금액 또는 %

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"L01",

"command":" DISCOUNTAPPLY",

"transtype":"REQUEST",

"result":”0”

},

"body":

{

"code":"001",

"kind":"G",

"type":"T",

"value":"10"

}

}

Response

Key

Key Name

Type

Length

Required

Description

Head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (DISCOUNTAPPLY)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

Body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"L01",

"targetid":"S01",

"command":" LPRCtl",

"transtype":"RESPONSE",

"result":”0”

}

}

할인등록정보전달 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/discount/apply
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
Code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ], "svr_key":"0001", "local_key":"0001" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

수동 할인 적용 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (DISCOUNTAPPLY)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
code	String	가변	Y	할인 구분 코드
kind	String	가변	Y	G:일반, R:감면
type	String	가변	Y	T:시간(분), P:금액, %:퍼센트	T:시간(분), P:금액, %:퍼센트
value	String	가변	Y	시간(분) 또는 금액 또는 %	시간(분) 또는 금액 또는 %

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"L01",

"command":" DISCOUNTAPPLY",

"transtype":"REQUEST",

"result":”0”

},

"body":

{

"code":"001",

"kind":"G",

"type":"T",

"value":"10"

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (DISCOUNTAPPLY)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"L01",

"targetid":"S01",

"command":" LPRCtl",

"transtype":"RESPONSE",

"result":”0”

}

}

수동 할인 적용 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/discount/apply
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ], "svr_key":"0001", "local_key":"0001" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

수동 할인 삭제

URI	http://[Domain or IP]:[Port]/svc/discount/delete
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y	I01:입구01, O01:출구01
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ], "svr_key":"0001", "local_key":"0001" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출구정산기 요금 표출(미인식) (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/fare/display
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
Data 예시
{ "equipment_name":"FM01", "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "equipment_ip":"127.0.0.1" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{"result":"0000","resultMessage":"정상처리"}

결제정보전달 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/inout/payment
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
car_no	차량 번호	String	가변	Y
payment_info	결제 정보	JsonArray	가변	Y
payment_info jsonArray 상세
equipment_name	결제 장치 명	String	가변	Y	O01:출구01
calc_start_datetime	정산 시작 시간	String	가변	Y
calc_end_datetime	정산 종료 시간	String	가변	Y
appl_date	승인 일자	String	가변	Y
appl_time	승인 시분초	String	가변	Y
appl_no	승인번호	String	가변	Y
appl_price	승인금액	String	가변	Y
tran_no	거래번호	String	가변	Y
terminal_no	단말기번호	String	가변	Y
pay_kind	지불 종류	String	가변	Y	1: 카드, 2:현금 ….
pay_type	지불 형태	String	가변	Y	1: 일반카드, 2: 교통카드, 3: 삼성페이 …..
card_code	카드 종류	String	가변	Y	CCBC: BC카드
card_installment	카드 할부 개월수	String	가변	Y	00:일시불 02:2개월
fare_key	요금제 키	String	가변	Y
fare_name	요금제 명	String	가변	Y
fare_info	요금제 정보	JsonArray	가변	Y
fare_info JsonArray 상세
charge_type	과금 구간 형태	String	가변	Y	1: 무료, 2: 과금
charge_time	과금 구간 시간(분)	String	가변	Y
charge_frequency	과금 반복 횟수	String	가변	Y
charge_price	과금 금액	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "car_no":"11가1111", "payment_info":[ { "equipment_name":"FM01", "card_code":"CCBC", "appl_date":"20180816", "calc_start_datetime":"201808161000", "appl_time":"110101", "calc_end_datetime":"201808161100", "pay_kind":"1", "appl_no":"34567890", "appl_price":"6000", "tran_no":"100001000100001000", "terminal_no":"90110123456", "card_installment":"00", "pay_type":"1", "fare_info":[ { "charge_type":"2", "charge_frequency":"6", "charge_price":"1000", "charge_time":"10" } ], "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ] } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

결제정보전달 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/svc/inout/payment
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
car_no	차량 번호	String	가변	Y
payment_info	결제 정보	JsonArray	가변	Y
payment_info jsonArray 상세
equipment_name	결제 장치 명	String	가변	Y	O01:출구01
calc_start_datetime	정산 시작 시간	String	가변	Y
calc_end_datetime	정산 종료 시간	String	가변	Y
appl_date	승인 일자	String	가변	Y
appl_time	승인 시분초	String	가변	Y
appl_no	승인번호	String	가변	Y
appl_price	승인금액	String	가변	Y
tran_no	거래번호	String	가변	Y
terminal_no	단말기번호	String	가변	Y
pay_kind	지불 종류	String	가변	Y	1: 카드, 2:현금 ….
pay_type	지불 형태	String	가변	Y	1: 일반카드, 2: 교통카드, 3: 삼성페이 …..
card_code	카드 종류	String	가변	Y	CCBC: BC카드
card_installment	카드 할부 개월수	String	가변	Y	00:일시불 02:2개월
fare_key	요금제 키	String	가변	Y
fare_name	요금제 명	String	가변	Y
fare_info	요금제 정보	JsonArray	가변	Y
fare_info JsonArray 상세
charge_type	과금 구간 형태	String	가변	Y	1: 무료, 2: 과금
charge_time	과금 구간 시간(분)	String	가변	Y
charge_frequency	과금 반복 횟수	String	가변	Y
charge_price	과금 금액	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "car_no":"11가1111", "payment_info":[ { "equipment_name":"FM01", "card_code":"CCBC", "appl_date":"20180816", "calc_start_datetime":"201808161000", "appl_time":"110101", "calc_end_datetime":"201808161100", "pay_kind":"1", "appl_no":"34567890", "appl_price":"6000", "tran_no":"100001000100001000", "terminal_no":"90110123456", "card_installment":"00", "pay_type":"1", "fare_info":[ { "charge_type":"2", "charge_frequency":"6", "charge_price":"1000", "charge_time":"10" } ], "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ] } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

미납정보전달 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/svc/inout/debtInfo
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
car_no	차량 번호	String	가변	Y
debt_info	미납 결제 정보	JsonArray	가변	Y
payment_info jsonArray 상세
equipment_name	결제 장치 명	String	가변	Y	O01:출구01
calc_start_datetime	정산 시작 시간	String	가변	Y
calc_end_datetime	정산 종료 시간	String	가변	Y
local_debt_key	로컬미납일련번호	String	가변	Y
debt_type	미납 형태	String	가변	Y	1: 도주, 2: 입금 거부, ……
debt_price	미납 금액	String	가변	Y
fare_key	요금제 키	String	가변	Y
fare_name	요금제 명	String	가변	Y
fare_info	요금제 정보	JsonArray	가변	Y
fare_info JsonArray 상세
charge_type	과금 구간 형태	String	가변	Y	1: 무료, 2: 과금
charge_time	과금 구간 시간(분)	String	가변	Y
charge_frequency	과금 반복 횟수	String	가변	Y
charge_price	과금 금액	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "car_no":"11가1111", "debt_info":[ { "equipment_name":"FM01", "appl_date":"20180816", "calc_start_datetime":"201808161000", "calc_end_datetime":"201808161100", "debt_price":"6000", "debt_local_key":"D000001", "debt_type":"1", "fare_info":[ { "charge_type":"2", "charge_frequency":"6", "charge_price":"1000", "charge_time":"10" } ], "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ] } ] }
Response
Result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	String	가변	Y
resultData JsonObject 상세
debt_info	미납 결제정보	JsonArray	가변	Y
debt_info JsonArray 상세
local_debt_key	로컬미납일련번호	String	가변	Y
svr_debt_key	서버미납일련번호	String	가변	Y
vact_use_yn	가상계좌사용여부	String	가변	Y	Y: 사용, N: 미사용
vact_bank_code	가상계좌은행코드	String	가변	Y
vact_bank_name	가상계좌은행명	String	가변	Y
vact_num	가상계좌번호	String	가변	Y
Data 예시
{ "result":"0000" ,"resultMessage":"정상처리" ,"resultData":{ "debt_info":[ { "local_debt_key":"D00001", "svr_debt_key":"DS00001", "vact_use_yn:"Y", "vact_bank_code:"01", "vact_bank_name:"신한은행", "vact_num:"012340123401234" } ] } }

미납목록조회 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/inout/debtlist
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
car_number	차량번호	String	가변	Y
Data 예시
{ "park_seq":"0001", "car_number":"01가0001" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	String	가변	Y
resultData JsonObject 상세
debt_list	미납 리스트	JsonArray	가변	Y
debt_list JsonArray 상세
local_debt_key	로컬미납일련번호	String	가변	Y
svr_debt_key	서버미납일련번호	String	가변	Y
car_number	차량번호	String	가변	Y
enter_datetime	입차시간	String	가변	Y
exit_datetime	출차시간	String	가변	Y
debt_image_url	미납 차량 이미지 URL	String	가변	Y
base_debt_price	기본미납금액	String	가변	Y
extra_debt_price	가산미납금액	String	가변	Y
pay_ny	지불 여부	String	가변	Y	Y:미납 결제, N:미납 미 결제
Data 예시
{ "result":"0000", "resultData":{ "debt_list":[ { "local_debt_key":"0001", "svr_debt_key":"0001", " car_number":"01가0001", " enter_datetime":"2018-01-01 00:00:00", " enter_datetime":"2018-01-01 00:40:00", " debt_image_url”:"http://parkgimg.seoul.co.kr/debt/20180101/0001.jpg", "base_debt_price":"1000", "extra_debt_price":"3000", "pay_ny":"N" } ] }, "resultMessage":"정상처리" }

미납결제정보전송 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/svc/inout/debtPayment
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_debt_key	로컬미납일련번호	String	가변	Y
svr_debt_key	서버미납일련번호	String	가변	Y
car_number	차량 번호	String	가변	Y
equipment_name	결제 장치 명	String	가변	Y	O01:출구01
appl_date	승인 일자	String	가변	Y
appl_time	승인 시분초	String	가변	Y
appl_no	승인번호	String	가변	Y
appl_price	승인금액	String	가변	Y
tran_no	거래번호	String	가변	Y
terminal_no	단말기번호	String	가변	Y
pay_kind	지불 종류	String	가변	Y	1: 카드, 2:현금 ….
pay_type	지불 형태	String	가변	Y	1: 일반카드, 2: 교통카드, 3: 삼성페이 …..
card_code	카드 종류	String	가변	Y	CCBC: BC카드
card_installment	카드 할부 개월수	String	가변	Y	00:일시불 02:2개월
Data 예시
{ "park_seq":"0001", "svr_debt_key":"0001", "local_debt_key":"0001", "car_number”:"11가1111", "equipment_name":"FM01", "card_code":"CCBC", "appl_date":"20180816", "appl_time":"110101", "pay_kind":"1", "appl_no":"34567890", "appl_price":"6000", "tran_no":"100001000100001000", "terminal_no":"90110123456", "card_installment":"00", "pay_type":"1" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출구정산기 재기동 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (FareMachineRestart)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
					T:시간(분), P:금액, %:퍼센트
					시간(분) 또는 금액 또는 %

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"FMO01",

"command":" FareMachineRestart",

"transtype":"REQUEST",

"result":”0”

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (FareMachineRestart)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"FMO01",

"targetid":"S01",

"command":" FareMachineRestart",

"transtype":"RESPONSE",

"result":”0”

}

}

출구정산기 재기동 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/inout/faremachine
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:출구정산기01, FMO02:출구정산기02
Data 예시
{ "park_seq":"0001", "equipment_list":[ { "equipment_name":"FMO01", "equipment_ip":"127.0.0.1" }, { "equipment_name":"FMO01", "equipment_ip":"127.0.0.2" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	String	가변	Y
resultData JsonObject 상세
equipment_list	장비리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FMO01:출구정산기01, FMO02:출구정산기02
restart_result	재기동 결과	String	가변	Y	0000: 정상처리, 그외: 오류
Data 예시
{ "result":"0000", "resultData":{ "equipment_list":[ { "equipment_name":"FMO01", "restart_result":"0000", "equipment_ip":"127.0.0.1" }, { "equipment_name":"FMO02", "restart_result":"0001", "equipment_ip":"127.0.0.2" } ] }, "resultMessage":"정상처리" }

사전정산기 재기동 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (FareMachineRestart)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
					T:시간(분), P:금액, %:퍼센트
					시간(분) 또는 금액 또는 %

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"FM01

"command":" FareMachineRestart",

"transtype":"REQUEST",

"result":”0”

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (FareMachineRestart)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"FM01",

"targetid":"S01",

"command":" FareMachineRestart",

"transtype":"RESPONSE",

"result":”0”

}

}

사전정산기 재기동 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/faremachine
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01: 정산기01, FM02: 정산기02
Data 예시
{ "park_seq":"0001", "equipment_list":[ { "equipment_name":"FM01", "equipment_ip":"127.0.0.1" }, { "equipment_name":"FM01", "equipment_ip":"127.0.0.2" } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	String	가변	Y
resultData JsonObject 상세
equipment_list	장비리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:출구정산기01, FM02:출구정산기02
restart_result	재기동 결과	String	가변	Y	0000: 정상처리, 그외: 오류
Data 예시
{ "result":"0000", "resultData":{ "equipment_list":[ { "equipment_name":"FM01", "restart_result":"0000", "equipment_ip":"127.0.0.1" }, { "equipment_name":"FM02", "restart_result":"0001", "equipment_ip":"127.0.0.2" } ] }, "resultMessage":"정상처리" }

입구안내전광판갱신 (주차카운트변경) (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (ParkCount)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
parkcount	String	가변	Y	현 주차 차량 수
parkfull	String	가변	Y	만차 설정
parkfulltxt	String	가변	Y	만차 설정 문구

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":" DIDI01

"command":"ParkCount",

"transtype":"REQUEST",

"result":”0”

},

"body":

{

"parkcount":"12",

"parkfull":"0",

"parkfulltxt":"주차가능”

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (ParkCount)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":" DIDI01",

"targetid":"S01",

"command":"ParkCount",

"transtype":"RESPONSE",

"result":”0”

}

}

입구안내전광판갱신 (주차카운트변경) (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/gate/in/parkcount
Direction	센터®로컬
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	10	Y
equipment_ip	장치 IP	String	가변	Y
equipment_name	장치 명	String	가변	Y	DIDI01:입구안내전광판01
parkcount	현 주차차량 수	String	가변	Y
parkfull	만차설정	String	가변	Y	0: 해제, 1: 만차
parkfulltxt	만차설정문구	String	가변	Y	주차가능/주차불가
Data 예시
{ "park_seq":"0001" , " equipment_ip":"192.168.0.1" , " equipment_name":"DIDI01" , " parkcount ":" 12" , “parkfull”:”0” , “parkfulltxt”:”주차가능” }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":”정상처리” }

사전등록확인 (로컬 센터)

URI	http://[Domain or IP]:[Port]/external/pre_registration
Ditection	로컬 -> 센터					14, 15, 16
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_ip	장치 IP	String	가변	Y
equipment_name	장치 명	String	가변	Y	I01:입구01
carno	차량번호	String	가변	Y	차량번호
Data 예시
{ "park_seq":"0001" , " equipment_ip":"192.168.0.1" , " equipment_name":"I01" , " carno":"12라1234" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	String	가변	Y
resultData JsonObject 상세
carno	차량번호	String	가변	Y
reg_yn	등록여부	String	가변	Y
paykey	결제가상번호	String	가변	Y	한국스마트카드와 업무협의 필요
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" , "resultData":{ " carno:"12라1234”, ,”reg_yn”:”Y”, ,”paykey”:” c3y2w6gkbtcDdf23xccHpGoJlsj” } }

사전정산기 요금 표출 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/fare/display
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:사전정산기01, FM02:사전정산기02
local_key	로컬 주차 일련번호	String	가변	Y
svr_key	서버 주차 일련번호	String	가변	Y
Data 예시
{ "equipment_name":"FM01", "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "equipment_ip":"127.0.0.1" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{"result":"0000","resultMessage":"정상처리"}

사전정산기 영수증 출력 (로컬 ® 기기)

Request

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (FarePrint)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description
local_key	String	가변	Y	로컬 입차 키
svr_key	String	가변	Y	서버 입차 키

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"S01",

"targetid":"FM01",

"command":" FarePrint",

"transtype":"REQUEST",

"result":”0”

},

"body":

{

" local_key”:”000001",

"svr_key":"000001"

}

}

Response

Key

Key Name

Type

Length

Required

Description

head

공통 해더

JSON Object

가변

Y

Key	Type	Length	Required	Description
pversion	String	가변	Y	프로토콜 버전
sourceid	String	가변	Y	송신 식별자
targetid	String	가변	Y	수신 식별자
command	String	가변	Y	요청 종류 식별자 (FarePrint)
transtype	String	가변	Y	요청/응답 구분 REQUEST: 요청, RESPONSE: 응답
result	String	가변	Y	결과 코드 (0: 성공)

body

바디

JSON Object

가변

Y

Key	Type	Length	Required	Description

Data 예시

{

"head":

{

"pversion":"20180817",

"sourceid":"FM01",

"targetid":"S01",

"command":" FarePrint",

"transtype":"RESPONSE",

"result":”0”

}

}

사전정산기 영수증 출력 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/fare/print
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:사전정산기01, FM02:사전정산기02
local_key	로컬 주차 일련번호	String	가변	Y
svr_key	서버 주차 일련번호	String	가변	Y
Data 예시
{ "equipment_name":"FM01", "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "equipment_ip":"127.0.0.1" }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{"result":"0000","resultMessage":"정상처리"}

출차 정보 전달 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/inout/carLeave
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
equipment_name	장치 명	String	가변	Y	O01:출구01
exit_datetime	입차 시간	String	가변	Y
car_no	차량 번호	String	가변	Y
exit_file_path	이미지 파일 경로	String	가변	Y	이미지 경로
exit_file_name	이미지 파일 이름	String	가변	Y	이미지 파일 이름
exit_image_base64	이미지 base64	String	가변	Y	이미지 Base64 stream
parking_type	주차 종류	String	가변	Y	1: 월정기, 2:시간주차 ….
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면,
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "equipment_name":"O01", "park_seq":"0001", "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ], "svr_key":"0001", "exit_file_path":"C:\\IMG\\OUT\\20180101\\", "local_key":"0001", "exit_datetime":"20180101000000", "car_no":"11가1111", "parking_type":"1", "exit_image_base64":".....", "exit_file_name":"0001_O01_11가111_20180101000000.jpg" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

출차 정보 전달 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/svc/inout/carLeave
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
equipment_name	장치 명	String	가변	Y	O01:출구01
exit_datetime	입차 시간	String	가변	Y
car_no	차량 번호	String	가변	Y
exit_file_path	이미지 파일 경로	String	가변	Y	이미지 경로
exit_file_name	이미지 파일 이름	String	가변	Y	이미지 파일 이름
parking_type	주차 종류	String	가변	Y	1: 월정기, 2:시간주차 ….
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면,
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "equipment_name":"O01", "park_seq":"0001", "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ], "svr_key":"0001", "exit_file_path":"C:\\IMG\\OUT\\20180101\\", "local_key":"0001", "exit_datetime":"20180101000000", "car_no":"11가1111", "parking_type":"1", "exit_file_name":"0001_O01_11가111_20180101000000.jpg" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

주차 요금결제정보 전달 (기기 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/inout/payment
한국스마트 카드 연동 프로토콜 확인 후 재정의 필요
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
car_no	차량 번호	String	가변	Y
payment_info	결제 정보	JsonArray	가변	Y
payment_info jsonArray 상세
equipment_name	결제 장치 명	String	가변	Y	O01:출구01
calc_start_datetime	정산 시작 시간	String	가변	Y
calc_end_datetime	정산 종료 시간	String	가변	Y
appl_date	승인 일자	String	가변	Y
appl_time	승인 시분초	String	가변	Y
appl_no	승인번호	String	가변	Y
appl_price	승인금액	String	가변	Y
tran_no	거래번호	String	가변	Y
terminal_no	단말기번호	String	가변	Y
pay_kind	지불 종류	String	가변	Y	1: 카드, 2:현금 ….
pay_type	지불 형태	String	가변	Y	1: 일반카드, 2: 교통카드, 3: 삼성페이 …..
card_code	카드 종류	String	가변	Y	CCBC: BC카드
card_installment	카드 할부 개월수	String	가변	Y	00:일시불 02:2개월
fare_key	요금제 키	String	가변	Y
fare_name	요금제 명	String	가변	Y
fare_info	요금제 정보	JsonArray	가변	Y
fare_info JsonArray 상세
charge_type	과금 구간 형태	String	가변	Y	1: 무료, 2: 과금
charge_time	과금 구간 시간(분)	String	가변	Y
charge_frequency	과금 반복 횟수	String	가변	Y
charge_price	과금 금액	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "car_no":"11가1111", "payment_info":[ { "equipment_name":"FM01", "card_code":"CCBC", "appl_date":"20180816", "calc_start_datetime":"201808161000", "appl_time":"110101", "calc_end_datetime":"201808161100", "pay_kind":"1", "appl_no":"34567890", "appl_price":"6000", "tran_no":"100001000100001000", "terminal_no":"90110123456", "card_installment":"00", "pay_type":"1", "fare_info":[ { "charge_type":"2", "charge_frequency":"6", "charge_price":"1000", "charge_time":"10" } ], "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ] } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

주차 요금결제정보 전달 (로컬 ® 기기)

URI	http://[Domain or IP]:[Port]/svc/inout/payment
한국스마트 카드 연동 프로토콜 확인 후 재정의 필요
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
car_no	차량 번호	String	가변	Y
payment_info	결제 정보	JsonArray	가변	Y
payment_info jsonArray 상세
equipment_name	결제 장치 명	String	가변	Y	O01:출구01
calc_start_datetime	정산 시작 시간	String	가변	Y
calc_end_datetime	정산 종료 시간	String	가변	Y
appl_date	승인 일자	String	가변	Y
appl_time	승인 시분초	String	가변	Y
appl_no	승인번호	String	가변	Y
appl_price	승인금액	String	가변	Y
tran_no	거래번호	String	가변	Y
terminal_no	단말기번호	String	가변	Y
pay_kind	지불 종류	String	가변	Y	1: 카드, 2:현금 ….
pay_type	지불 형태	String	가변	Y	1: 일반카드, 2: 교통카드, 3: 삼성페이 …..
card_code	카드 종류	String	가변	Y	CCBC: BC카드
card_installment	카드 할부 개월수	String	가변	Y	00:일시불 02:2개월
fare_key	요금제 키	String	가변	Y
fare_name	요금제 명	String	가변	Y
fare_info	요금제 정보	JsonArray	가변	Y
fare_info JsonArray 상세
charge_type	과금 구간 형태	String	가변	Y	1: 무료, 2: 과금
charge_time	과금 구간 시간(분)	String	가변	Y
charge_frequency	과금 반복 횟수	String	가변	Y
charge_price	과금 금액	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "car_no":"11가1111", "payment_info":[ { "equipment_name":"FM01", "card_code":"CCBC", "appl_date":"20180816", "calc_start_datetime":"201808161000", "appl_time":"110101", "calc_end_datetime":"201808161100", "pay_kind":"1", "appl_no":"34567890", "appl_price":"6000", "tran_no":"100001000100001000", "terminal_no":"90110123456", "card_installment":"00", "pay_type":"1", "fare_info":[ { "charge_type":"2", "charge_frequency":"6", "charge_price":"1000", "charge_time":"10" } ], "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ] } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

주차 요금 결제정보 저장 (로컬 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/inout/payment_save
한국스마트 카드 연동 프로토콜 확인 후 재정의 필요
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
car_no	차량 번호	String	가변	Y
payment_info	결제 정보	JsonArray	가변	Y
payment_info jsonArray 상세
equipment_name	결제 장치 명	String	가변	Y	O01:출구01
calc_start_datetime	정산 시작 시간	String	가변	Y
calc_end_datetime	정산 종료 시간	String	가변	Y
appl_date	승인 일자	String	가변	Y
appl_time	승인 시분초	String	가변	Y
appl_no	승인번호	String	가변	Y
appl_price	승인금액	String	가변	Y
tran_no	거래번호	String	가변	Y
terminal_no	단말기번호	String	가변	Y
pay_kind	지불 종류	String	가변	Y	1: 카드, 2:현금 ….
pay_type	지불 형태	String	가변	Y	1: 일반카드, 2: 교통카드, 3: 삼성페이 …..
card_code	카드 종류	String	가변	Y	CCBC: BC카드
card_installment	카드 할부 개월수	String	가변	Y	00:일시불 02:2개월
fare_key	요금제 키	String	가변	Y
fare_name	요금제 명	String	가변	Y
fare_info	요금제 정보	JsonArray	가변	Y
fare_info JsonArray 상세
charge_type	과금 구간 형태	String	가변	Y	1: 무료, 2: 과금
charge_time	과금 구간 시간(분)	String	가변	Y
charge_frequency	과금 반복 횟수	String	가변	Y
charge_price	과금 금액	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "car_no":"11가1111", "payment_info":[ { "equipment_name":"FM01", "card_code":"CCBC", "appl_date":"20180816", "calc_start_datetime":"201808161000", "appl_time":"110101", "calc_end_datetime":"201808161100", "pay_kind":"1", "appl_no":"34567890", "appl_price":"6000", "tran_no":"100001000100001000", "terminal_no":"90110123456", "card_installment":"00", "pay_type":"1", "fare_info":[ { "charge_type":"2", "charge_frequency":"6", "charge_price":"1000", "charge_time":"10" } ], "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ] } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

주차 요금 결제정보 전달 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/svc/inout/payment
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
car_no	차량 번호	String	가변	Y
payment_info	결제 정보	JsonArray	가변	Y
payment_info jsonArray 상세
equipment_name	결제 장치 명	String	가변	Y	O01:출구01
calc_start_datetime	정산 시작 시간	String	가변	Y
calc_end_datetime	정산 종료 시간	String	가변	Y
appl_date	승인 일자	String	가변	Y
appl_time	승인 시분초	String	가변	Y
appl_no	승인번호	String	가변	Y
appl_price	승인금액	String	가변	Y
tran_no	거래번호	String	가변	Y
terminal_no	단말기번호	String	가변	Y
pay_kind	지불 종류	String	가변	Y	1: 카드, 2:현금 ….
pay_type	지불 형태	String	가변	Y	1: 일반카드, 2: 교통카드, 3: 삼성페이 …..
card_code	카드 종류	String	가변	Y	CCBC: BC카드
card_installment	카드 할부 개월수	String	가변	Y	00:일시불 02:2개월
fare_key	요금제 키	String	가변	Y
fare_name	요금제 명	String	가변	Y
fare_info	요금제 정보	JsonArray	가변	Y
fare_info JsonArray 상세
charge_type	과금 구간 형태	String	가변	Y	1: 무료, 2: 과금
charge_time	과금 구간 시간(분)	String	가변	Y
charge_frequency	과금 반복 횟수	String	가변	Y
charge_price	과금 금액	String	가변	Y
discount_info	할인정보	JsonArray	가변	Y
discount_info JsonArray 상세
code	할인 코드	String	가변	Y	할인 구분 코드
kind	할인 종류	String	가변	Y	G:일반, R:감면
type	할인 방법	String	가변	Y	T:시간(분), P:금액, %:퍼센트
value	할인 값	String	가변	Y	시간(분) 또는 금액 또는 %
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "car_no":"11가1111", "payment_info":[ { "equipment_name":"FM01", "card_code":"CCBC", "appl_date":"20180816", "calc_start_datetime":"201808161000", "appl_time":"110101", "calc_end_datetime":"201808161100", "pay_kind":"1", "appl_no":"34567890", "appl_price":"6000", "tran_no":"100001000100001000", "terminal_no":"90110123456", "card_installment":"00", "pay_type":"1", "fare_info":[ { "charge_type":"2", "charge_frequency":"6", "charge_price":"1000", "charge_time":"10" } ], "discount_info":[ { "code":"001", "kind":"G", "type":"T", "value":"10" } ] } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

결제 취소 정보 전달 [로컬 취소] (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/svc/inout/paymentCancel
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
car_no	차량 번호	String	가변	Y
payment_info	결제 정보	JsonArray	가변	Y
payment_info jsonArray 상세
appl_date	승인 일자	String	가변	Y
appl_time	승인 시분초	String	가변	Y
appl_no	승인 번호	String	가변	Y
appl_price	승인 금액	String	가변	Y
tran_no	거래 번호	String	가변	Y
terminal_no	단말기 번호	String	가변	Y
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "car_no":"11가1111", "payment_info":[ { "appl_price":"6000", "tran_no":"100001000100001000", "appl_date":"20180816", "terminal_no":"90110123456", "appl_time":"110101", "appl_no":"34567890" } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

결제 취소 정보 전달 [로컬 취소] (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/inout/paymentCancel
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
car_no	차량 번호	String	가변	Y
payment_info	결제 정보	JsonArray	가변	Y
payment_info jsonArray 상세
appl_date	승인 일자	String	가변	Y
appl_time	승인 시분초	String	가변	Y
appl_no	승인 번호	String	가변	Y
appl_price	승인 금액	String	가변	Y
tran_no	거래 번호	String	가변	Y
terminal_no	단말기 번호	String	가변	Y
Data 예시
{ "park_seq":"0001", "svr_key":"0001", "local_key":"0001", "car_no":"11가1111", "payment_info":[ { "appl_price":"6000", "tran_no":"100001000100001000", "appl_date":"20180816", "terminal_no":"90110123456", "appl_time":"110101", "appl_no":"34567890" } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

수동 입차 처리 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/svc/inout/manualCarEnter
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
equipment_name	장치 명	String	가변	Y	I01:입구01
enter_datetime	입차 시간	String	가변	Y
car_no	차량 번호	String	가변	Y
regman	근무자	String	가변	Y	근무자
Data 예시
{ "equipment_name":"I01", "park_seq":"0001", "local_key":"0001", "car_no":"11가1111", "enter_datetime":"20180101000000", " regman":"1234" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000", "resultMessage":"정상처리", }

수동 입차 처리 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/inout/manualCarEnter
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
equipment_name	장치 명	String	가변	Y	I01:입구01
enter_datetime	입차 시간	String	가변	Y
car_no	차량 번호	String	가변	Y
regman	근무자	String	가변	Y	근무자
Data 예시
{ "equipment_name":"I01", "park_seq":"0001", "local_key":"0001", "car_no":"11가1111", "regman":"1234"", }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	JsonObject	가변	Y
resultData JsonObject 상세
local_key	로컬주차일련번호	String	가변	Y
Data 예시
{ "result":"0000", "resultMessage":"정상처리", "resultData":{ " local_key":"000001 } }

수동 출차 처리 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/svc/inout/manualCarExit
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
local_key	로컬주차일련번호	String	가변	Y
equipment_name	장치 명	String	가변	Y	O01:출구01
exit_datetime	출차 시간	String	가변	Y
car_no	차량 번호	String	가변	Y
regman	근무자	String	가변	Y	근무자
Data 예시
{ "equipment_name":"I01", "park_seq":"0001", "local_key":"0001", "car_no":"11가1111", "exit_datetime":"20180101000000", "regman":"1234" }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	JsonObject	가변	Y
resultData JsonObject 상세
svr_key	서버주차일련번호	String	가변	Y
Data 예시
{ "result":"0000", "resultMessage":"정상처리", "resultData":{ "svr_key":"000001", } }

수동 출차 처리 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/inout/manualCarExit
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
svr_key	서버주차일련번호	String	가변	Y
equipment_name	장치 명	String	가변	Y	O01:출구01
enter_datetime	입차 시간	String	가변	Y
car_no	차량 번호	String	가변	Y
regman	근무자	String	가변	Y	근무자
Data 예시
{ "equipment_name":"I01", "park_seq":"0001", "local_key":"0001", "car_no":"11가1111", "regman":"1234"", }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
resultData	응답데이터	JsonObject	가변	Y
resultData JsonObject 상세
local_key	로컬주차일련번호	String	가변	Y
Data 예시
{ "result":"0000", "resultMessage":"정상처리", "resultData":{ " local_key":"000001 } }

요금제 등록/수정 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/inout/fareRegister
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
fare_info	결제 정보	JsonArray	가변	Y
payment_info jsonArray 상세
fare_seq	요금제 키	String	가변	Y
fare_name	요금제 명	String	가변	Y
cartype_key	차량 타입	String	가변	Y
max_payment	최대 요금	JsonArray	가변	Y
max_payment JsonArray 상세 정보
order_seq	순서	String	가변	Y
fare_money	요금 금액	String	가변	Y
repeat_cnt	반복 개수	String	가변	Y
fare_week_info	요일 별 요금 정보	JsonArray	가변	Y
fare_week_info JsonArray 상세
week_idx	요일 구분자	String	가변	Y
week_name	요일 명	String	가변	Y
week_fare_info	요일 요금제 정보	JsonArray	가변	Y
week_fare_info JsonArray 상세
day_id	일 요금제 키	String	가변	Y
day_name	일 요금제 명	String	가변	Y
service_time	서비스 시간	String	가변	Y
reg_time	사전정산 후 서비스 시간	String	가변	Y
grace_time	금액 정산 시 버림 처리하는 단위 시간	String	가변	Y
apply_stime	적용 시작 시간	String	가변	Y
apply_etime	적용 종료 시간	String	가변	Y
day_fare_info	일 요금제 정보	JsonArray	가변	y
day_fare_info JsonArray 상세
base_ny	기본 구간 여부	String	가변	Y
continue_ny	요금 변경 구간 기본 구간 반영 여부	String	가변	Y
order_seq	반영 순서	String	가변	Y
time_value	요금 구간 시간	String	가변	Y
repeat_cnt	요금 구간 반복 횟수	String	가변	Y
apply_money	요금 구간 금액	String	가변	Y
Data 예시
{ "park_seq":"0001", "fare_info": [ { "fare_seq":1, "fare_name":"일반", "cartype_key":"A", "max_payment": [ { "order_seq":1, "fare_money":30000, "repeat_cnt":0 } ], "fare_week_info": [ { "week_idx":1, "week_name":"월요일", "week_fare_info": [ { "day_id":1, "day_name":"주간", "service_time":0, "reg_time":30, "grace_time":0, "apply_stime":"0900", "apply_etime":"1959", "day_fare_info": [ { "base_ny":"Y", "continue_ny":"N", "order_seq":1, "time_value":30, "repeat_cnt":1, "apply_money":1000 }, { "base_ny":"N", "continue_ny":"N", "order_seq":1, "time_value":10, "repeat_cnt":1, "apply_money":500 } ] }, { "day_id":2, "day_name":"야간", "service_time":0, "reg_time":30, "grace_time":0, "apply_stime":"20:00", "apply_etime":"08:59", "day_fare_info": [ { "base_ny":"Y", "continue_ny":"N", "order_seq":1, "time_value":30, "repeat_cnt":1, "apply_money":1000 }, { "base_ny":"N", "continue_ny":"N", "order_seq":1, "time_value":10, "repeat_cnt":1, "apply_money":500 } ] } ] } ] } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

주차장 정보 등록/수정 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/park/register
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
park_name	주차장 명	String	가변	Y
alliance_name	제휴 명	String	가변	Y
alliance_lience_no	사업자 등록 번호	String	가변	Y
address	주소	String	가변	Y
tel_no	전화번호	String	가변	Y
open_info	운영정보	JsonArray	가변	Y
open_info JsonArray 상세
week_idx	요일 구분	String	가변	Y
week_name	요일 명	String	가변	Y
open_type	운영 형태	String	가변	Y
open_stime	운영 시작시간	String	가변	Y
opne_etime	운영 종료시간	String	가변	Y
Data 예시
{ "park_seq":9999, "park_name":"OOO주차장", "alliance_name":"테스트주차장", "alliance_lience_no":"000-00-00000", "address":"서울시 영등포구 영등포로 3길 19", "tel_no":"1588-5783", "open_info": [ { "week_idx":"0", "week_name":"일요일", "open_type":"0", "open_stime":"00:00", "open_etime":"00:00", }, { "week_idx":"1", "week_name":"월요일", "open_type":"1", "open_stime":"00:00", "open_etime":"24:00", }, { "week_idx":"2", "week_name":"화요일", "open_type":"1", "open_stime":"00:00", "open_etime":"24:00", }, { "week_idx":"3", "week_name":"수요일", "open_type":"1", "open_stime":"00:00", "open_etime":"24:00", }, { "week_idx":"4", "week_name":"목요일", "open_type":"1", "open_stime":"00:00", "open_etime":"24:00", }, { "week_idx":"5", "week_name":"금요일", "open_type":"1", "open_stime":"00:00", "open_etime":"24:00", }, { "week_idx":"6", "week_name":"토요일", "open_type":"0", "open_stime":"00:00", "open_etime":"00:00", }, { "week_idx":"7", "week_name":"공휴일", "open_type":"0", "open_stime":"00:00", "open_etime":"00:00", } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

월정기권 상품정보 전송 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/regular/productRegister
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
product_info	정기권 상품 정보	JsonArray	가변	Y
regular_info JsonArray 상세
product_key	정기권 상품 일련번호	String	가변	Y
product_name	상품명	String	가변	Y
product_daynight	상품종류	String	가변	Y	1:전일, 2:주간, 3:야간
product_week	상품적용요일	String	가변	Y	0;1;2;3;4;5;6; (0:일, 1:월, 2:화, 3:수, 4:목, 5:금, 6:토)
product_price	상품금액	String	가변	Y
apply_start_datetime	적용 시작 시간	String	가변	Y
apply_end_datetime	적용 종료 시간	String	가변	Y
Data 예시
{ "park_seq":"00001", "product_info": [ { "product_key":925856, "product_name":”전일”, "product_daynight":”1”, "product_week":"0;1;2;3;4;5;6;”, "product_price":”150000”, " apply_start_datetime":"00:00:00”, " apply_end_datetime ":"23:59:59" }, { "product_key":925857, "product_name":”평일주간”, "product_daynight":”2”, "product_week":"1;2;3;4;5;”, "product_price":”75000”, " apply_start_datetime":"09:00:00”, " apply_end_datetime ":"18:00:00" } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

월정기권 주차장 이관 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/regular/register
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
regular_info	정기권 정보	JsonArray	가변	Y
regular_info JsonArray 상세
product_key	월정기권상품일련번호	String	가변	Y
request_id	요청ID	String	가변	Y
request_no	요청번호	String	가변	Y
carno	차량번호	String	가변	Y
trans_ex_yn	환승여부	String	가변	Y
charge	요금	String	가변	Y
start_datetime	정기권 시작 일시	String	가변	Y
end_datetime	정기권 종료 일시	String	가변	Y
user_name	사용자명	String	가변	Y
daynight	주야간	String	가변	Y
reg_yn	등록여부	String	가변	Y
reg_datetime	등록일시	String	가변	Y
Data 예시
{ "park_seq":"00001", "regular_info": [ { "prodcut_key":”00001”, "request_id":925856, "request_no":201703000003540, "carno":"12다3456", "trans_ex_yn":1, "charge":"40000”, "carno":"11가1111", "user_name":"홍길동", "start_datetime":"2018-01-01 00:00:00", "end_datetime":"2018-01-31 23:59:59", "daynight":"RC0803", "reg_yn":"Y", "reg_dateTime":"2018-08-31 23:16:09.027" } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

월정기권 결제정보 전송 (로컬 ® 센터)

URI	http://[Domain or IP]:[Port]/svc/regular/payment
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
payment_info	정기권 정보	JsonArray	가변	Y
regular_info JsonArray 상세
product_key	월정기권상품일련번호	String	가변	Y
request_id	요청ID	String	가변	Y
request_no	요청번호	String	가변	Y
carno	차량번호	String	가변	Y
appl_date	승인 일자	String	가변	Y
appl_time	승인 시분초	String	가변	Y
appl_no	승인번호	String	가변	Y
appl_price	승인금액	String	가변	Y
tran_no	거래번호	String	가변	Y
terminal_no	단말기번호	String	가변	Y
pay_kind	지불 종류	String	가변	Y	1: 카드, 2:현금 ….
pay_type	지불 형태	String	가변	Y	1: 일반카드, 2: 교통카드, 3: 삼성페이 …..
card_code	카드 종류	String	가변	Y	CCBC: BC카드
card_installment	카드 할부 개월수	String	가변	Y	00:일시불 02:2개월
Data 예시
{ "park_seq":"00001", "payment_info": [ { "prodcut_key":”00001”, "request_id":925856, "request_no":201703000003540, "carno":"12다3456", " appl_date ":”20180801”, " appl_time":"04000”, " appl_no ":"12312345", " appl_price":"150000", "tran_no":"01234567890123456789", "pay_kind":"1”, "pay_type":"1", "card_code":"CCBC", " card_installment":"00" } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

무료정기권 전송 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/svc/regular/freeRegister
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
free_regular_info	정기권 정보	JsonArray	가변	Y
regular_info JsonArray 상세
request_id	요청ID	String	가변	Y
request_no	요청번호	String	가변	Y
carno	차량번호	String	가변	Y
start_datetime	정기권 시작 일시	String	가변	Y
end_datetime	정기권 종료 일시	String	가변	Y
user_name	사용자명	String	가변	Y
free_reason_code	무료사유코드	String	가변	Y	1:공무수행, 2:시의원, …. 99:기타
free_reason_memo	무료사유메모	String	가변	Y
use_yn	사용여부	String	가변	Y	Y:사용, N:미사용
reg_yn	등록여부	String	가변	Y
reg_datetime	등록일시	String	가변	Y
Data 예시
{ "park_seq":"00001", "free_regular_info": [ { "request_id":925856, "request_no":201703000003540, "carno":"11가1111", "user_name":"홍길동", "start_datetime":"2018-01-01 00:00:00", "end_datetime":"2018-01-31 23:59:59", "free_reason_code":"1", "free_reason_memo":"공무수행", "use_yn":"Y", "reg_yn":"Y", "reg_dateTime":"2018-08-31 23:16:09.027" } ] }
Response
result	응답코드	String	가변	Y
resutlMessage	응답메시지	String	가변	Y
Data 예시
{ "result":"0000" , "resultMessage":"정상처리" }

장비목록 (로컬 ® 센터)

관리대상 장비

장비명	장비코드	코드범위	설치위치	비고
사전정산기	FM01	FM01 ~ FM99	중앙
출구정산기	FMO01	FMO01 ~ FMO99	출구
입구차단기	I01	I01~I99	입구
입구LPR	LI01	LI01~LI99	입구
출구차단기	O01	O01~O99	출구
출구LPR	LO01	LO01~LO99	출구

URI	http://[Domain or IP]:[Port]/equipment_list
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
equipment_code	장치코드	String	가변	Y	관리대상 장비 참조
Equipment_alias	장치명 별칭	String	가변	Y
Data 예시
{ “park_seq”:”0001”, “equipment_list”:[ { “equipment_code:”FM01”, “equipment_name:”사전정산기01”, “equipment_alias”:”본관사전정산기01”, “equipment_ip”:”127.0.0.11” }, { “equipment_code:”LI01”, “equipment_name:”입구LPR01”, “equipment_alias”:”동문입구LPR01, “equipment_ip”:”127.0.0.12” } { “equipment_code:”I01”, “equipment_name:”입구01”, “equipment_alias”:”동문입구01”, “equipment_ip”:”127.0.0.13” } { “equipment_code:”FMO01”, “equipment_name:”출구정산기01”, “equipment_alias”:”동문출구정산기01, “equipment_ip”:”127.0.0.21” } { “equipment_code:”LO01”, “equipment_name:”출구LPR01”, “equipment_alias”:”동문출구LPR01”, “equipment_ip”:”127.0.0.22” } { “equipment_code:”O01”, “equipment_name:”출구01”, “equipment_alias”:”동문출구01”, “equipment_ip”:”127.0.0.23” } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{“result”:”0000”,”resultMessage”:”정상처리”}

장비목록 (센터 ® 로컬)

URI	http://[Domain or IP]:[Port]/equipment_list
Request
Key	Key Name	Type	Length	Required	Description
park_seq	주차장 일련번호	String	가변	Y
equipment_list	장치 리스트	JsonArray	가변	Y
equipment_list JsonArray 상세
equipment_ip	장치 IP	String	가변	Y	장치 IP
equipment_name	장치 명	String	가변	Y	FM01:정산기01, FM02:정산기02
equipment_code	장치코드	String	가변	Y	관리대상 장비 참조
Equipment_alias	장치명 별칭	String	가변	Y
Data 예시
{ “park_seq”:”0001”, “equipment_list”:[ { “equipment_code:”FM01”, “equipment_name:”사전정산기01”, “equipment_alias”:”본관사전정산기01”, “equipment_ip”:”127.0.0.11” }, { “equipment_code:”LI01”, “equipment_name:”입구LPR01”, “equipment_alias”:”동문입구LPR01, “equipment_ip”:”127.0.0.12” } { “equipment_code:”I01”, “equipment_name:”입구01”, “equipment_alias”:”동문입구01”, “equipment_ip”:”127.0.0.13” } { “equipment_code:”FMO01”, “equipment_name:”출구정산기01”, “equipment_alias”:”동문출구정산기01, “equipment_ip”:”127.0.0.21” } { “equipment_code:”LO01”, “equipment_name:”출구LPR01”, “equipment_alias”:”동문출구LPR01”, “equipment_ip”:”127.0.0.22” } { “equipment_code:”O01”, “equipment_name:”출구01”, “equipment_alias”:”동문출구01”, “equipment_ip”:”127.0.0.23” } ] }
Response
result	응답코드	String	가변	Y	0000:정상처리 그외: 실패
resutlMessage	응답메시지	String	가변	Y
Data 예시
{“result”:”0000”,”resultMessage”:”정상처리”}

개발 가이드

연동 및 권고 사항

구분	항목	필수	비고
응답 속도	서버의 응답 시간은 9초 이내	Y	9초를 초과할 경우, 별도 협의
동시 접속 및 회선 속도	예상 동시 접속자(주당 1회 접속 시) = 예상 가입자 수 / (24시간*7일 )/ 60분 / 60초 예상 회선 속도 = 예상 동시 접속자 * 1개 API * 800바이트 * 8 예) 예상 가입자 수 : 10,000,000 명 - 예상 동시 접속자 = 17 명 - 예상 회선 속도 = 106 Kbps	Y	전용선 포함
응답 코드	API 규격서에 정의된 응답 코드 이외의 응답 코드는 서비스 담당자와 협의 후 연동	Y
시스템 작업 공지	시스템에 대한 작업 공지는 작업 시작 일시 최소 3일 전에 담당자에게 공지	Y
모니터링 시스템	안정적인 서비스를 위하여 서비스 상태(장애 등) 모니터링 시스템 운영	N	전체 서비스 구간은 서비스 사

API 구현

- 응답 시, Header 부분에 대하여 추적 번호, 암호화 코드 등은 요청 측의 값을 유지하여 응답한다.

- 응답 시, Body 부분에 대하여 추가적인 기재가 필요 없을 시 요청 측의 값을 유지한다.

서버 정보

- 시스템 담당자에게 문의하여 주시기 바랍니다.

참고

사용 코드

Classification	Code Name	Code & Description

응답 코드

Code	Description(Message)
0000	*정상
MXXX	서버 처리 오류
1XXX	전문 관련 오류
1101	Header 필수 항목 누락
1102	Header 크기 불일치
1103	Header 타입 불일치
1201	Body 필수 항목 누락
1202	Body 크기 불일치
1203	Body 타입 불일치
1300	*암복호화 에러
1301	*암호화 에러
1302	*복호화 에러
1000	기타 오류
2XXX	처리 오류
2000	기타 오류
9999	*타임아웃(Timeout)