볼거리,즐긱거리,누릴거리 천년온천 유성의 천가지 즐거움! 유성구 문화관광 홈페이지 방문을 환영합니다.
> 여행가이드 > 이용안내 > Open API

Open API

페이스북 트위터 인쇄하기

Open API

유성군 Open API 서비스는 정부3.0에 의해 홈페이지내의 공공정보를 민간에 공개하고 소통함으로써 공익성, 업무효율성, 투명성을 높이고 홈페이지 이용자의 자발적 참여로 새로운 서비스와 공공의 가치를 창출할 수 있도록 하는 서비스입니다.

기본사용법
(1)XML 방식
http://tour.yuseong.go.kr/board/openApi/list.do?boardId={게시판ID}&authApiKey={API인증키}
사용 예)
http://tour.yuseong.go.kr/board/openApi/list.do?boardId=TOUR_CULTURE&authApiKey=xxxxxxxxxxxx
(2)JSON 방식
http://tour.yuseong.go.kr/board/openApi/list.do?boardId={게시판ID}&authApiKey={API인증키}&restMode=json
사용 예)
http://tour.yuseong.go.kr/board/openApi/list.do?boardId=TOUR_CULTURE&authApiKey=xxxxxxxxxxxx&restMode=json
검색 파라미터
검색 파라미터
번호 설명 파라미터명 기타
1 게시판ID boardId 게시판ID boardId=BBS_0000001
2 OPENAPI인증키 authApiKey 발급된인증KEY authApiKey=DSAJRXSORTBLNFX
3 검색 필드 searchType 검색 필드명(검색어와 함께사용) searchType=DATA_TITLE 하단 검색필드 참조
4 검색 키워드 keyword 검색어(검색 필드와 함께 사용) keyword=%ED%95%B4%EC%9A%B4%EB%8C%80 <<해운대 한글검색시 인코딩필요
5 검색 카테고리 categoryCode1~3 데이터 구분값(1:타입구분,2:지역구분,3:미사용) categoryCode1=AA01 categoryCode2=AREA01 하단 카테고리 참조, 다중 카테고리 검색시,를 사용하여 다중입력
6 페이징 startPage 페이징 값 startPage=1
7 시작일 searchStartDt 게시물 공지기간 시작일 searchStartDt=2012-09-01 일정게시판의 경우 행사 시작일
8 종료일 searchEndDt 게시물 공지기간 종료일 searchEndDt=2012-09-31 일정게시판의 경우 행사 종료일
파라미터값 참조
파라미터값 참조
번호 필드키 항목 필드구분
1 USER_ID 아이디 기본
2 USER_TEL 전화번호 기본
3 USER_CEL 핸드폰 기본
4 USER_ZIPCODE 우편번호 기본
5 USER_ADDRESS 주소 기본
6 USER_DETAILADDR 상세주소 기본
7 USER_HOMEPAGE 홈페이지 기본
8 DATA_TITLE 제목 기본
9 DATA_CONTENT 내용 기본
10 CATEGORY_CODE1 카테고리 기본
11 TMP_FIELD1 규모 기본
12 TMP_FIELD2 좌표X 기본
13 TMP_FIELD3 좌표Y 기본
14 FILE_MEMO 이미지 기본
15 carinfo 자가용 확장
16 detailintroduce 소개 확장
17 facilitiesguide 시설안내 확장
18 inareainfo 지역내 대중교통 확장
19 intime 입실시간 확장
20 outareainfo 지역간 대중교통 확장
21 outtime 퇴실시간 확장
22 parkingcnt 주차시설 확장
23 roominfo 객실정보 확장
24 useinfo1 인터넷예약 확장
25 useinfo2 전화예약 확장
26 useinfo3 애완동물동반 확장
27 useinfo4 조식제공 확장
노드 설명
노드 설명
노드1 노드2 노드3 노드4 노드5 설명
boardDataList         게시물 목록
  list       각 각의 게시물 정보
    boardId     게시판 ID
    categoryCode1~3     카테고리 코드
    dataContent     게시물 내용(기본정보)
    dataContentRemoveTag     게시물 내용중 태그삭제(BR태그만 개항 표시용도로 사용)
    dataSid     게시물 고유값
    dataTitle     게시물 제목(관광지 명)
    extensionDataList     게시판 기본정보 외의 확장 필드목록 (상단 필드 정보 참조)
      list   확장 필드 정보
    fileList     첨부파일정보
      list    
        fileMask 물리적 파일명(서버상의 파일명)
        fileName 논리적 파일명(실제 파일명)
        fileStatus 첨부파일 관리 상태(N인 첨부파일만 사용)
    userHomepage     홈페이지 URL
    viewCount     열람횟수
boardSearchVO         검색 파라미터 정보
boardVO         게시판 정보
code         OPENAPI 처리 코드
configVO         게시물 관련 부가 정보
  dataCount       게시물 총 개수
  thumbnailFilePath       썸네일 이미지 경로(썸네일경로+fileMask)
  uploadFilePath       첨부파일 경로(첨부파일 경로+fileMask)
msg         OPENAPI처리 메시지
이용안내

OPEN 공공누리 공공저작물 자유이용허락 출처표시, 상업용금지, 변경금지

유성구청 문화관광과에서 제작한 "Open API" 저작물은 "공공누리" 출처표시-상업적이용금지-변경금지 조건에 따라 이용 할 수 있습니다.