DMZ통합정보시스템 API
[ 개발가이드 다운로드 ]
■ DMZ통합정보시스템 오픈API 목록
API |
구분코드 |
설명 |
평화생태마을 API |
area_village |
안전행정부에서 진행하는 '평화생태마을 조성사업'에 선정된 접경지역 마을 정보를 제공합니다. |
찾아가고싶은섬 API |
area_island |
안전행정부에서 진행하는 '찾아가고 싶은 섬 가꾸기 사업'에 선정된 접경지역 섬 정보를 제공합니다. |
안보여행 API |
tour_security |
DMZ를 더욱 가까이에서 느낄 수 있는 안보여행지 정보를 제공합니다. |
자연체험 API |
tour_nature |
DMZ 인근의 아름다운 자연을 체험할 수 있는 산과 바다, 강과 계곡 등의 자연 여행지 정보를 제공합니다. |
역사탐험 API |
tour_history |
우리의 오랜 전통과 다양한 문화를 느낄 수 있는 역사와 문화 관련 여행지 정보를 제공합니다. |
여가활동 API |
tour_leisure |
즐거운 레저와 편안한 휴식 등 다양한 여가활동이 가능한 곳의 정보를 제공합니다. |
축제즐기기 API |
tour_festival |
접경지역에서 즐길 수 있는 월별 축제 정보를 제공합니다. |
맛집거리 API |
restaurant |
접경지역에는 다양한 맛집들이 많이 있습니다. 그중 테마별로 조성된 맛집거리 정보를 제공합니다. |
숙박 API |
accommodations |
단체숙박이 가능한 국가 및 자치단체 운영 숙박시설, 템플스테이가 가능한 사찰 등의 정보를 제공합니다. |
특산물 API |
speciality |
접경지역 15개 시군의 특산물 관련 정보와 판매처 등의 정보를 제공합니다. |
■ 지역 코드
지역명 |
코드 |
지역명 |
코드 |
지역명 |
코드 |
강화군 |
A |
고양시 |
F |
화천군 |
K |
옹진군 |
B |
양주시 |
G |
양구군 |
L |
김포시 |
C |
동두천시 |
H |
인제군 |
M |
파주시 |
D |
포천시 |
I |
고성군 |
N |
연천군 |
E |
철원군 |
J |
춘천시 |
O |
■ 요청 URL (Request URL)
서비스 |
요청 URL |
콘텐츠 목록 |
http://dmz.go.kr/front/contentxml?servicekey={servicekey}&pageNo={페이지번호}&numOfRows={레코드수}&board_code={API종류}&area_code={지역} |
콘텐츠 상세 |
http://dmz.go.kr/front/contentxml/view?servicekey={servicekey}&uid={레코드번호} |
콘텐츠 검색 |
http://dmz.go.kr/front/contentxml/search?servicekey={servicekey}&sname=검색어}&pageNo={페이지번호}&numOfRows={레코드수}&board_code={API종류}&area_code={지역} |
■ 요청 메소드 (Method)
GET
■ 콘텐츠 목록 조회
• 요청 메시지 (Request Parameters)
항목명(영문) |
항목명(국문) |
항목크기 |
항목구분 |
샘플데이터 |
항목설명 |
Servicekey |
서비스 키 |
32 |
필수 |
|
발급받은 서비스 키 |
numOfRows |
레코드 수 |
5 |
필수 |
10 |
레코드 갯수 |
pageNo |
페이지번호 |
5 |
필수 |
1 |
페이지 번호 |
board_code |
API 구분코드 |
20 |
필수 |
tour_security |
사용하려는 API의 구분 코드 |
area_code |
지역분류 |
2 |
옵션 |
A |
지역 코드 값 |
• 결과(성공) 메시지 (Response Parameters)
항목명(영문) |
항목명(국문) |
항목크기 |
항목구분 |
샘플데이터 |
항목설명 |
resultCode |
결과코드 |
2 |
필수 |
|
결과 코드 값 |
resultMsg |
결과 메시지 |
50 |
필수 |
1 |
요청 결과 메세지 |
numOfRows |
레코드 수 |
10 |
필수 |
10 |
조회 결과 레코드 갯수 |
pageNo |
페이지 번호 |
4 |
필수 |
1 |
페이지 번호 |
totalCount |
전체 레코드 수 |
4 |
필수 |
3 |
전체 레코드 갯수 |
items |
목록 |
|
0..n |
|
item 목록 |
subject |
제목 |
510 |
1..n |
[김포] 교동도 |
콘텐츠 제목 |
regidate |
등록일자 |
10 |
1..n |
2014-08-15 00:00:00 |
등록일자 |
• 결과(실패) 메시지 (Response Parameters)
항목명(영문) |
항목명(국문) |
항목크기 |
항목구분 |
샘플데이터 |
항목설명 |
resultCode |
결과코드 |
2 |
필수 |
|
결과 코드 값 |
resultMsg |
결과 메시지 |
50 |
필수 |
1 |
요청 결과 메세지 |
• 결과 메시지 샘플
<response> |
■ 콘텐츠 상세 조회
• 요청 메시지 (Request Parameters)
항목명(영문) |
항목명(국문) |
항목크기 |
항목구분 |
샘플데이터 |
항목설명 |
Servicekey |
서비스 키 |
32 |
필수 |
|
발급받은 서비스 키 |
Uid |
콘텐츠 번호 |
10000 |
필수 |
92 |
콘텐츠 고유 번호 |
• 결과(성공) 메시지 (Response Parameters)
항목명(영문) |
항목명(국문) |
항목크기 |
항목구분 |
샘플데이터 |
항목설명 |
resultCode |
결과코드 |
2 |
필수 |
|
결과 코드 값 |
resultMsg |
결과 메시지 |
50 |
필수 |
|
요청 결과 메세지 |
boardcode |
게시판 코드 |
50 |
1..n |
|
게시판 코드 |
boardsubject |
제목 |
600 |
1..n |
대이작도 | 콘텐츠 제목 |
boardcontent |
내용 |
1000000 |
1..n |
상세 내용 |
콘텐츠 내용 |
homepage |
홈페이지 주소 |
100 |
1..n |
http:// |
홈페이지 주소 |
address |
주소 |
200 |
1..n |
김포시 |
주소 |
add1 |
정가 |
500 |
1..n |
|
정가 |
add2 |
쪽수 |
500 |
1..n |
|
쪽수 |
add3 |
이용시간 |
500 |
1..n |
|
이용시간 |
add4 |
쉬는 날 |
500 |
1..n |
|
쉬는 날 |
add5 |
축제기간, 저자 |
500 |
1..n |
|
축제기간, 저자 |
add6 |
출판사, 제작사 |
500 |
1..n |
|
출판사, 제작사 |
add7 |
문의/안내 |
500 |
1..n |
|
문의/안내 |
regidate |
등록일자 |
500 |
1..n |
|
등록일자 |
• 결과(실패) 메시지 (Response Parameters)
항목명(영문) |
항목명(국문) |
항목크기 |
항목구분 |
샘플데이터 |
항목설명 |
resultCode |
결과코드 |
2 |
필수 |
|
결과 코드 값 |
resultMsg |
결과 메시지 |
50 |
필수 |
1 |
요청 결과 메세지 |
• 결과 메시지 샘플
<response> |
■ 콘텐츠 검색
• 요청 메시지 (Request Parameters)
항목명(영문) |
항목명(국문) |
항목크기 |
항목구분 |
샘플데이터 |
항목설명 |
Servicekey |
서비스 키 |
32 |
필수 |
|
발급받은 서비스 키 |
Sname |
검색 단어 |
100 |
필수 |
김포 |
검색할 단어 |
numOfRows |
레코드 수 |
5 |
필수 |
10 |
레코드 갯수 |
pageNo |
페이지 번호 |
5 |
필수 |
1 |
페이지 번호 |
• 결과(성공) 메시지 (Response Parameters)
항목명(영문) |
항목명(국문) |
항목크기 |
항목구분 |
샘플데이터 |
항목설명 |
resultCode |
결과코드 |
2 |
필수 |
|
결과 코드 값 |
resultMsg |
결과 메시지 |
50 |
필수 |
1 |
요청 결과 메세지 |
numOfRows |
레코드 수 |
10 |
필수 |
10 |
조회 결과 레코드 갯수 |
pageNo |
페이지 번호 |
4 |
필수 |
1 |
페이지 번호 |
totalCount |
전체 레코드 수 |
4 |
필수 |
3 |
전체 레코드 갯수 |
items |
목록 |
|
0..n |
|
item 목록 |
subject |
제목 |
510 |
1..n |
[김포] 교동도 |
콘텐츠 제목 |
regidate |
등록일자 |
10 |
1..n |
2014-08-15 00:00:00 |
등록일자 |
• 결과(실패) 메시지 (Response Parameters)
항목명(영문) |
항목명(국문) |
항목크기 |
항목구분 |
샘플데이터 |
항목설명 |
resultCode |
결과코드 |
2 |
필수 |
|
결과 코드 값 |
resultMsg |
결과 메시지 |
50 |
필수 |
1 |
요청 결과 메세지 |
• 결과 메시지 샘플
<response> |
