Service
국가유산청 국가유산 목록에서 국보·보물·사적·명승·천연기념물·무형유산·민속유산과 시도 지정 유산을 이름·종목·지역·날짜로 찾고, 사진·이용허락·음성 해설까지 전체 기록을 읽으며, 그 달의 국가유산 행사도 조회합니다.
100.00%30일 가동률평균 응답2256ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-heritage/get-heritage | Reads one designated heritage item in full by its heritage_id: classification, quantity, designation and cancellation dates, address, era, owner, manager, description, main photo and the photo gallery with KOGL licence terms. Use after a search returned a heritage_id and the caller wants the details. Do NOT use to find items (use search-heritage) or for narration (use get-heritage-narration). Returns the item's fields plus classification_path, designated_on, address, era, owner, description and images; an unknown id is NO_DATA. | |
| POST | /v1/korea-heritage/get-heritage-narration | Finds the audio narration (mp3) of one designated heritage item in Korean, English, Japanese or Chinese. Use when someone wants to listen to a guide about an item. Do NOT use for the written description (use get-heritage). Returns the item's name, the language and audio_url; null when the service lists no narration in that language. | |
| POST | /v1/korea-heritage/list-districts | Lists the districts of one region of South Korea with the codes search-heritage takes as district_code. Use when you need a district code, or want to see which districts a region has. Do NOT use to find heritage items; use search-heritage. Returns districts with code and name, including the 00 entry that means the whole region. | |
| POST | /v1/korea-heritage/list-heritage-images | Lists the photos of one designated heritage item with their captions and KOGL licence terms (which types allow commercial use or changes, and whether AI-generated). Use when the caller wants the gallery alone, or needs the licence of each photo before reusing it. Do NOT use to read the item's record (use get-heritage). Returns the item's name and images with sequence, image_url, caption, license, ai_generated, commercial_use_allowed and modification_allowed; an item without photos has an empty list. | |
| POST | /v1/korea-heritage/search-heritage | Finds designated heritage items in South Korea by name, designation type (national treasure, treasure, historic site, natural monument, intangible heritage, provincial designations...), region and district, designation year or last change date, active or cancelled. Use when someone names a heritage item or asks what a region or type has. Do NOT use to read one item in full (use get-heritage) or for programmes and events (use search-heritage-events). Returns heritage rows with heritage_id, name, designation type, region, district, manager, coordinates and last change, one page at a time with total_count and has_more. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-heritage/search-heritage-events | Lists the heritage programmes and events of one month in South Korea (night tours, living-heritage programmes, temple and Confucian-academy programmes, old-house stays, world-heritage events...), optionally one type or a title word. Use when someone asks what heritage events are on in a month. Do NOT use for the heritage items themselves (use search-heritage) or for past months, which the service no longer lists. Returns events with event_id, type, title, dates, schedule, venue, region, organizer, contact, audience, fee and link, sorted by start date, one page at a time with total_count and has_more. |