정보소통광장 위젯 및 오픈 API 사용 안내

 

 

검색 위젯 퍼가기

블로그와 카페에 정보소통광장 검색 위젯을 탑재하시면 보다 편리하게 이용하실 수 있습니다. 아래 iFrame 소스코드를 블로그나 웹사이트에 넣으시면, 해당 사이트에서 정보소통광장의 콘텐츠를 바로 검색할 수 있습니다.

 

적용 예시

검색 위젯 적용 예시

 

  • 위의 적용 예시와 같이 블로그나 웹사이트의 사이드바 혹은 위젯 영역에 위젯 코드를 넣으면 작동됩니다.
  • ※ 단, 일부 호스팅 블로그 등은 보안상 이유로 HTML 등을 허용하지 않을 수 있음을 유념하시기 바랍니다.
  • ※ 워드프레스 등에서는 편리하게 이용하실 수 있습니다.

 

서비스 이용방법

1) 너비 100px에 맞는 위젯

(위젯 소스)
<iframe title="정보소통광장 검색 위젯" width="100%" height="25px" frameborder="0" scrolling="auto" src="http://opengov.seoul.go.kr/openwid1"></iframe>

  • 상기 위젯 소스를 사이드바 등에 삽입하고, 실제로 잘 동작하는지 확인합니다.
  • 너비와 높이 등은 별도로 수정할 수 있습니다.

 

적용예:

 

2) 너비 120px에 맞는 위젯

(위젯 소스)
<iframe title="정보소통광장 검색 위젯" width="100%" height="25px" frameborder="0" scrolling="auto" src="http://opengov.seoul.go.kr/openwid2"></iframe>

  • 상기 위젯 소스를 사이드바 등에 삽입하고, 실제로 잘 동작하는지 확인합니다.
  • 너비와 높이 등은 별도로 수정할 수 있습니다.

 

적용예:

 

3) 너비 160px에 맞는 위젯

(위젯 소스)
<iframe title="정보소통광장 검색 위젯" width="100%" height="25px" frameborder="0" scrolling="auto" src="http://opengov.seoul.go.kr/openwid3"></iframe>

  • 상기 위젯 소스를 사이드바 등에 삽입하고, 실제로 잘 동작하는지 확인합니다.
  • 너비와 높이 등은 별도로 수정할 수 있습니다.

 

적용예:

 

목록 위젯 퍼가기

결재문서, 정책연구자료의 목록 위젯을 블로그와 사이트에 탑재하시면 정보소통광장에 오지 않아도 콘텐츠를 사용자에게 제공할 수 있습니다. 아래 iFrame 소스코드의 기관 변수를 적절히 수정하시어 적용하시면 원하는 기관의 행정정보를 목록 형태로 제공할 수 있습니다.

 

적용 예시

iframe 삽입 사례

 

서비스 이용방법

1) 적용 소스코드 및 변수 적용 방법

(샘플)
<iframe title="{제목 입력}" width="{너비 지정}px" height="{높이 지정}px" frameborder="0" scrolling="auto" src="http://opengov.seoul.go.kr/openweb?gvrncd={기관 코드 지정}"></iframe>

(예제1)
<iframe title="보건환경연구원 정책연구자료 목록" width="700px" height="800px" frameborder="0" scrolling="auto" src="http://opengov.seoul.go.kr/openweb?gvrncd=100303"></iframe>

(예제2)
<iframe title="강남구청 결재문서 목록" width="100%" height="850px" frameborder="0" scrolling="auto" src="http://opengov.seoul.go.kr/openweb?gvrncd=100038"></iframe>

 

  • 위의 샘플에 녹색으로 표시되어 있는 영역을 알맞게 조정하면 원하는 콘텐츠 목록을 서비스할 수 있습니다.
  • 제목 입력 : 콘텐츠 목록에 대한 제목을 입력하시면 됩니다. (예: 서대문구의 결재문서 목록, 서울연구소 정책연구자료 목록)
  • 너비 및 높이 지정 : 너비(width) 및 높이(height)를 픽셀(px)이나 상대값(%)으로 지정하시면 됩니다.
  • 기관 코드 지정 : src 뒤에 URL은 그대로 두고, 녹색 부분에 기관 코드를 입력하시면 됩니다.
  • ※샘플이나 예제와 같이 필요한 변수를 조합한 뒤, 내 블로그나 웹사이트에 탑재하면 됩니다.

 

2) 결재문서 제공 기관의 변수 정의

정보소통광장 목록 위젯의 기관 변수 정의표
기관명 변수 코드 기관명 변수 코드
서울시 본청100001마포구100029
강남구100038서대문구100028
강동구100040서초구100037
강북구100024성동구100019
강서구100031성북구100023
관악구100036송파구100039
광진구100020양천구100030
구로구100032영등포구100034
금천구100033용산구100018
노원구100026은평구100027
도봉구100025종로구100016
동대문구100021중구100017
동작구100035중랑구100022
(재)서울문화재단100202서울신용보증재단100212
(재)서울시립교향악단100216서울연구원100214
서울디자인재단100210서울장학재단100203
서울메트로100213서울특별시 서울의료원100217
서울산업진흥원100215서울특별시도시철도공사100204
서울시 여성가족재단100206서울특별시시설관리공단100207
서울시농수산식품공사100209세종문화회관100205
서울시복지재단100201에스에이치공사(SH공사)100208
서울시자원봉사센터100211--

 

3) 정책연구기관의 변수 정의

정보소통광장 목록 위젯의 기관 변수 정의표
기관명 변수 코드 기관명 변수 코드
SH공사 도시연구소100308서울시복지재단100301
기술용역100305서울시여성가족재단100306
기술용역 심사결과100005서울연구원 100313
보건환경연구원100303서울특별시의회100309
서울디자인재단100310학술용역100304
서울물연구원100302학술용역 심사결과100004
서울시립대학교서울녹색환경지원센터100312한성백제박물관100307
서울시립대학교서울학연구소100311--

 

나만의 검색 위젯 만들기

HTML과 간단한 JS를 활용하시면 나만의 검색 위젯을 만들어 사용자에게 서비스할 수 있습니다.

 

적용 예시

샘플 화면

 

서비스 이용방법

1) 샘플 안내

(위젯소스)
<div style="border: 0px none black; padding: 0px;"> <form name="search" method="get" action="http://opengov.seoul.go.kr/search" target="_blank" accept-charset="UTF-8"> <input type="text" name="searchKeyword" placeholder="정보소통광장" style="width: 100px;height:30px;text-align:center;" title="검색어입력"> <input type="submit" value="검색" style="width: 60px;height:30px;background-color:darkblue;"> </form> </div>

 

  • 위의 예제에 녹색으로 표시된 곳이 너비 및 높이, 배경색 등을 지정하는 스타일 영역입니다.
  • 너비(width) 및 높이(height), 색상(color / background) 등을 지정하면 내가 원하는 대로 위젯을 수정할 수 있습니다.
  • ※ 단, 일부 호스팅 블로그 등은 보안상 이유로 HTML 등을 허용하지 않을 수 있음을 유념하시기 바랍니다.
  • ※ 워드프레스 등에서는 테마의 컨셉과 디자인에 맞게 수정하여 편리하게 이용하실 수 있습니다.

 

2) 스타일 안내

스타일 안내
스타일명 설명 적용예
width 너비를 지정. 픽셀(px)이나 상대값(%)을 지정할 수 있음 width:100%;
width:100px;
height 높이를 지정. 픽셀(px) 등을 지정할 수 있음(고정값 권장) height:30px;
text-align 텍스트 정렬 방식을 지정. 왼쪽 정렬(left), 중앙정렬(center), 오른쪽 정렬(right)으로 지정함. text-align:left;
text-align:center;
background-color 배경 색상을 지정 background-color:gray;
background-color:red;

 

오픈API 신청(고급 개발자용)

정보소통광장에서는 콘텐츠 검색 오픈 API 서비스를 제공하고 있습니다. 서울시의 다양하고 방대한 행정정보 콘텐츠 중 나에게 필요한 부분을 선별할 수 있으며, 요청에 대한 결과는 JSON형태로 제공되므로 이를 통하여 사용자가 원하는 디자인의 형태로 구현할 수 있습니다.

 

오픈 API 신청

  • 담당부서 : 서울시 정보공개정책과
  • 연락처 : (02)2133-5672~3

 

서비스 이용방법

1) 요청 변수(request parameter)

오픈API 요청 변수 정의표
요청변수 내용 비고
gvrncdString <필수>기관코드를 입력하면 해당 기관에 대한 정보목록만 검색 가능
※참고 (**1) 기관코드
qstring검색어 입력. (예: 도서관)
※인코딩 문제로 인해 한글이 깨지는 경우에는 encodeURI 방식으로 인코딩 요망
pagenointeger검색 결과의 시작위치를 지정. 기본값 페이지 번호: 1
displayinteger기본값 10, 최대값 50: 검색결과 목록에 출력건수를 지정. 최대 50까지 사용.
sortstring기본값 score: 정렬옵션임.
score: 정확도
date: 최신 날짜 순
title: 제목 순
outputstring기본값: Json 결과 형식
Json: JSON 데이터
xml: XML데이터
startdatestring시작일: 문서 등록 시작일부터 검색
※형식: yyyy/mm/dd
enddatestring종료일: 문서 등록 종료일까지 검색
※형식: yyyy/mm/dd

 

2) 요청 결과 : JSON 방식

{
 "title":"행정사무감사 및 예산심의 관련 물품구입(11.25.)",
 "deptname":"민생경제과",
 "deptcd":"6113527",
 "gvrnname":"서울시",
 "gvrncd":"100001",
 "prodman":"이병구",
 "regdate":"2015/12/30 22:31:32",
 "docnum":"D0000024709810",
 "makedate":"2015/12/30 22:31:32",
 "gvrnrgstnum":"7112951",
 "astmtname":"민생경제과-29684",
 "dlsrname":"부분공개",
 "score":"0",
 "view_count":"3",
 "brm_cl_all_nm":"행정ㆍ기타",
 "url":"http://opengov.seoul.go.kr/share/7112951",
 "kwrd":",예산집행및회계관리,일상경비관리",
 "attach_nm":"지출품의서_20151229220804.pdf||지출결의서_20151229220804.pdf||결재문서본문.hwp",
 "attach_mime":"pdf||pdf||hwp",
"attach_uri":"/dcdata/100001/20151229/F0000045726590.pdf||/dcdata/100001/20151229/F0000045726589.pdf||/dcdata/100001/20151229/F0000045726588.hwp",
 "attach_bdt_yn":"N||N||Y",
 "append":"
    [ { "fileurl":"http://opengov.seoul.go.kr/sites/all/blocks/download.php?uri=%2Fdcdata%2F100001%2F20151229%2FF0000045726588.hwp", "filename":"결재문서본문.hwp"  } ]
}...