API 개요
비짓서울 API의 콘텐츠 목록 조회 API는 서울 관광 정보를 체계적으로 제공하는 핵심 서비스입니다.
이 API를 통해 관광지, 맛집, 숙박, 쇼핑, 축제 등 서울의 다양한 관광 콘텐츠 정보를 카테고리별, 언어별,
키워드별로 검색하고 조회할 수 있습니다.
요청 방법
HTTP 요청
POST /api/v1/contents/list
Host: api-call.visitseoul.net
VISITSEOUL-API-KEY: [발급받은 API 키]
Accept: application/json;charset=UTF-8
cURL 예시
curl -X 'POST' \
'https://api-call.visitseoul.net/api/v1/contents/list' \
-H 'Accept: application/json;charset=UTF-8' \
-H 'VISITSEOUL-API-KEY: [발급받은 API 키]' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
"com_ctgry_sn": "Cg1x6l1",
"lang_code_id": "ko",
"keyword": "전시",
"sort_type": "latest",
"page_no": 1
}'
파라미터 : 콘텐츠 목록 조회 API는 다음과 같은 파라미터를 포함할 수 있으며 모두 선택사항입니다.
응답 구조
성공 응답(200)
{
"data": [
{
"cid": "KOPsrn1p5",
"lang_code_id": "ko",
"com_ctgry_sn": "Cg1x6l1",
"cate_depth": [
" 문화관광 ",
"전시시설"
],
"multi_lang_list": "ko:KOPsrn1p5,en:ENPsrn1p5,ja:JPPsrn1p5,zh-CN:CNPsrn1p5,zh-TW:TCPsrn1p5",
"main_img": "https://이미지경로/파일명",
"post_sj": "서울 지하철 개통 50주년 기념 전시 <서울의 지하철>",
"sumry": "서울역사박물관X서울교통공사 공동 개최 기획전시 <서울의 지하철> ",
"creat_dt_text": "2024.08.16",
"updt_dt_text": "2024.10.30"
}
],
"paging": {
"page_no": 1,
"page_size": 50,
"total_count": 11
},
"result_code": 200,
"result_message": "OK"
}
응답 필드 설명