VISIT SEOUL api

생성일 : 2025.08.26
수정일 : 2025.10.20

API 개요

비짓서울 표준 콘텐츠는 자체 표준 카테고리를 사용하여 분류됩니다.
콘텐츠 목록을 조회할 때 카테고리 코드를 지정하여 해당 카테고리에 속하는 콘텐츠를 조회할 수 있습니다.
카테고리 구조는 자주 변경되지 않으므로 24시간 이상 장기간 캐싱하여 사용이 가능합니다.

요청 방법

HTTP 요청

GET /api/v1/category/list
Host: api-call.visitseoul.net
VISITSEOUL-API-KEY: [발급받은 API 키]
Accept: application/json;charset=UTF-8

cURL 예시

curl -X 'GET’ \
  'https://api-call.visitseoul.net/api/v1/category/list' \
  -H 'Accept: application/json;charset=UTF-8' \
  -H 'VISITSEOUL-API-KEY: [발급받은 API 키]'

파라미터 : 없음 (모든 카테고리 정보를 반환)

응답 구조

성공 응답(200)

{
  "data": [
 {
      "com_ctgry_sn": "Ca0o2d4",
      "ctgry_nm": "Culture",
      "ctgry_path": " Culture",
      "ctgry_level": 1,
      "sort_no": 1
    },
    {
      "com_ctgry_sn": "Ce9z7g9",
      "ctgry_nm": "Parks",
      "ctgry_path": " Culture > Parks",
      "ctgry_level": 2,
      "sort_no": 1
    }
  ],
  "result_code": 200,
  "result_message": "OK"
}

응답 필드 설명

필드명,타입,설명이 있는 응답 필드 설명
필드명	타입	설명
com_ctgry_sn	string	카테고리 고유 코드 (콘텐츠 조회 시 사용)
ctgry_nm	string	카테고리명
ctgry_path	string	카테고리 경로 (계층 구조 표시)
ctgry_level	integer	카테고리 레벨 (1: 최상위, 2: 하위, 3: 세부)
sort_no	integer	정렬 순서