- OS 구분 : IOS
- AND
- WIN
- 외 22개
- API 호출 결과의 상태 메시지
- API 호출 결과의 상태 코드
- 법정동 시도 코드
- 외 37개
설명
본 API는 한국관광공사 포토코리아(phoko.visitkorea.or.kr)에서 제공하는 관광공모전 사진 부문 수상작에 대한 제목, 촬영일, 촬영지, 키워드, 이미지 정보 등을 제공합니다.- 개방데이터는 법정동코드 정보, 관광공모전(사진) 수상작 정보, 관광공모전(사진) 수상작 동기화 정보 총 3종으로 구성되어 있으며, 관광공모전 사진 부문 수상작에 대한 정보를 제공합니다. - 개방데이터는 홍보물, 잡지 등 다양한 매체에서 활용할 수 있으며, 모바일 앱, 웹 서비스 등 신규/융복합 관광서비스 개발에도 활용할 수 있습니다.
요청변수 31개
| 이름 | 같은 이름 |
|---|---|
| OS 구분 : IOS (아이폰) | 찾아보기 |
| AND (안드로이드) | 찾아보기 |
| WIN (윈도우) | 찾아보기 |
| ETC | 찾아보기 |
| WIN (윈도우폰) | 찾아보기 |
| 검색 요청할 키워드 (국문=인코딩 필요) | 찾아보기 |
| 공공데이터포털에서 받은 인증키 | 찾아보기 |
| 공공데이터포털에서 받은 인증키(서비스키) | 찾아보기 |
| 법정동 시도 코드 | 찾아보기 |
| 분류체계 1Depth 코드 | 찾아보기 |
| 분류체계 2Depth 코드(lclsSystm1 필수) | 찾아보기 |
| 분류체계 3Depth 코드(lclsSystm1 | 찾아보기 |
| lclsSystm2 필수) | 찾아보기 |
| 분류체계 목록 조회 여부(N: 코드 조회 | 찾아보기 |
| Y: 전체 목록 조회) | 찾아보기 |
| 서비스명(어플명) | 찾아보기 |
| 응답메세지 형식: REST 방식의 URL 호출 시 json값 추가 (디폴트 응답메세지 형식 XML) | 찾아보기 |
| 정렬 구분 (A=제목순 | 찾아보기 |
| C=수정일순 | 찾아보기 |
| D=생성일순) | 찾아보기 |
| 대표 이미지 포함 정렬 (O=제목순 | 찾아보기 |
| Q=수정일순 | 찾아보기 |
| R=생성일순) | 찾아보기 |
| 대표 이미지가 반드시 있는 정렬 (O=제목순 | 찾아보기 |
| 대표 포함 정렬 (O=제목순 | 찾아보기 |
| 콘텐츠 수정일(형식: YYYYMMDD) | 찾아보기 |
| 콘텐츠표출여부 (1=표출 | 찾아보기 |
| 0=비표출) | 찾아보기 |
| 페이지 번호 | 찾아보기 |
| 한 페이지 결과 수 | 찾아보기 |
| 현재 페이지 번호 | 찾아보기 |
출력결과 45개
body header API 호출 결과의 상태 메시지 API 호출 결과의 상태 코드 item items 법정동 시도 코드 법정동 시도명 분류체계 대분류 코드 (lclsSystmListYn : Y일 때 표출) 분류체계 대분류명 (lclsSystmListYn : Y일 때 표출) 분류체계 소분류 코드 (lclsSystmListYn : Y일 때 표출) 분류체계 소분류명 (lclsSystmListYn : Y일 때 표출) 분류체계 중분류 코드 (lclsSystmListYn : Y일 때 표출) 분류체계 중분류명 (lclsSystmListYn : Y일 때 표출) 수상작(국문) 수상작(영문) 썸네일 대표 이미지 URL 응답 썸네일 대표 이미지(약 300 * 200 size) URL 응답 원본 대표 이미지 URL 응답 원본 대표 이미지(약 1620 * 1080 size) URL 응답 이미지 저작권 유형 - Type1: 제1유형(출처표시-권장) 일련번호 입상작(국문) 입상작(영문) 전체 데이터의 총 수 촬영 연월 촬영 장소(국문) 촬영 장소(영문) 촬영자(국문) 촬영자(영문) 코드: 1Depth 2Depth 3Depth 코드 (lclsSystmListYn : N일 때 표출) 3Depth 코드명 (lclsSystmListYn : N일 때 표출) 콘텐츠 ID 콘텐츠 수정일 콘텐츠 최초 등록일 콘텐츠명(국문) 콘텐츠명(영문) 콘텐츠표출여부 (1=표출 0=비표출) 키워드(국문) 키워드(영문) 한 페이지의 결과 수 현재 조회된 데이터의 페이지 번호
호출해 보기
주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.
curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
--data-urlencode 'serviceKey=발급받은_인증키' \
--data-urlencode 'OS 구분 : IOS (아이폰)=값' \
--data-urlencode 'AND (안드로이드)=값' \
--data-urlencode 'WIN (윈도우)=값' \
--data-urlencode 'ETC=값' \
--data-urlencode 'WIN (윈도우폰)=값' \
--data-urlencode '검색 요청할 키워드 (국문=인코딩 필요)=값'
const params = new URLSearchParams({
"serviceKey": "발급받은_인증키",
"OS 구분 : IOS (아이폰)": "값",
"AND (안드로이드)": "값",
"WIN (윈도우)": "값",
"ETC": "값",
"WIN (윈도우폰)": "값",
"검색 요청할 키워드 (국문=인코딩 필요)": "값",
});
const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
import requests
params = {
"serviceKey": "발급받은_인증키",
"OS 구분 : IOS (아이폰)": "값",
"AND (안드로이드)": "값",
"WIN (윈도우)": "값",
"ETC": "값",
"WIN (윈도우폰)": "값",
"검색 요청할 키워드 (국문=인코딩 필요)": "값",
}
r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())
같은 값을 넣을 수 있는 API
이 API 에 넣는 값을 그대로 쓸 수 있습니다
-
한국관광공사가 보유하고 있는 다양한 의료 관광 정보를 실시간으로 제공 받을 수 있으며, 국내 최대 관광정보 포털사이트(www.visitkorea.or.kr) 홈페이지에서 제공하는 의료 관광정보 중 저작권 등에 구애 없이 자유롭게 활용 가능한 정보만을 선별하여 OpenAPI를 통해서 최신 정보를 제공하고 있습니다. - 개방데이터는 법정동 코드 정보, 지역기반 관광정보, 위치기반 관광정보, 키워
-
본 API는 반려동물과 함께 여행할 수 있는 전국의 관광지, 숙소, 음식점, 쇼핑시설 등 다양한 장소의 관광정보를 제공합니다. 각 관광지의 기본 정보(운영 시간, 휴무일 등) 뿐만 아니라 반려동물 동반 조건, 반려동물 동반 시 유의사항, 반려동물 이용가능 시설 등의 상세정보를 제공하고 있습니다. 또한 지역기반 조회, (현재)위치기반 조회 등의 기능을 제공하며 파라미터에 따라 제목순, 수정일순
-
- 국내관광정보서비스 OpenAPI 신규 상세기능(법정동코드, 신분류코드) 안내 URL(https://api.visitkorea.or.kr/#/cmsNoticeDetail?no=207)- 장애인, 고령자, 영유아가족 등 '모든 관광객'이 이동의 불편 및 관광활동의 제약없이 이용할 수 있는 장애물 없는 정보이며,국내 최대 무장애 관광정보 포털 사이트 열린관광 모두의여행(access.visitk
-
한국관광공사가 보유하고 있는 다양한 웰니스 관광 정보를 실시간으로 제공 받을 수 있으며, 국내 최대 관광정보 포털사이트(www.visitkorea.or.kr) 홈페이지에서 제공하는 웰니스 관광정보 중 저작권 등에 구애 없이 자유롭게 활용 가능한 정보만을 선별하여 OpenAPI를 통해서 최신 정보를 제공하고 있습니다. - 개방 데이터는 법정동 코드 정보, 지역기반 관광정보, 위치기반 관광정보,
-
- 국내관광정보서비스 OpenAPI 신규 상세기능(법정동코드, 신분류코드) 안내 URL(https://api.visitkorea.or.kr/#/cmsNoticeDetail?no=207)- 한국관광공사가 보유하고 있는 전국의 다양한 관광정보와 사진정보를 실시간으로 제공 받을 수 있으며,국내 최대 관광정보 포털 사이트 Visitkorea(spanish.visitkorea.or.kr) 홈페이지에서
-
- 국내관광정보서비스 OpenAPI 신규 상세기능(법정동코드, 신분류코드) 안내 URL(https://api.visitkorea.or.kr/#/cmsNoticeDetail?no=207)- 한국관광공사가 보유하고 있는 전국의 다양한 관광정보와 사진정보를 실시간으로 제공 받을 수 있으며,국내 최대 관광정보 포털 사이트 Visitkorea(big5chinese.visitkorea.or.kr) 홈페