부산광역시교육청 부산광역시교육청교육연구정보원_통합예약포털 목록 조회 서비스

- 부산광역시교육청 통합예약포털 홈페이지는 부산광역시교육청 산하 유·초·중·고등학교 학생, 학부모, 학교(기관)들이 보다 편리하게 교육청(직속기관)에서 운영하는 다양한 프로그램을 확인하고 신청할 수 있도록 마련된 홈페이지입니다. - 부산광역시교육청 통합예약포털 예약목록 서비스(API)는 부산광역시교육청 통합예약포털(https://home.pen.go.kr/yeyak/main.do)에서 제공하는 견학체험, 교육연수, 공연행사 등의 예약 목록 데이터를 개방합니다. 본 데이터는 기관명, 예약명, 운영기간, 접수기간, 예약대상, 신청대상, 예약상태, 모집인원, 잔여좌석수, 장소, 운영기관 연락처 등 세부 정보를 포함하여, 이용자가 원하는 프로그램의 예약 현황을 쉽게 확인할 수 있도록 지원합니다.- 개방 데이터는 예약프로그램의 운영 현황과 참여 추이를 파악할 수 있으며, 교육·체험 프로그램 참여 기회 확대, 공공자원의 효율적 운영 및 이용자 편의 증진에 활용될 수 있습니다. 또한 기관별 예약 참여 현황, 시기별 예약 수요 변화 등을 분석하여 정책 수립, 행사 운영계획 수립, 교육서비스 품질 향상 등에도 기여할 수 있습니다.- 연구자나 시민은 해당 데이터를 활용하여 특정 기관이나 행사유형별 예약 현황을 비교·분석할 수 있고, 교육청은 데이터 기반으로 수요 맞춤형 프로그램 기획과 예약시스템 개선에 활용할 수 있습니다.

body header item items 결과메세지 결과코드 공연 스케줄 목록 공연구분 순번 공연구분명 공연대상 (참고자료 첨부파일 내 '체험_교육_공연대상 코드정보' 시트 참고) 공연대상 상세 공연명 공연순번 공연일 교육구분 (GNRL: 교육 CRSE: 강좌) 교육대상 (참고자료 첨부파일 내 '체험_교육_공연대상 코드정보' 시트 참고) 교육대상 상세 교육명 교육카테고리 순번 교육카테고리명 기관 국문명 기관 영문명 (참고자료 첨부파일 내 '기관 코드정보' 시트 참고) 대기가능인원(단위: 명) 대기인원(단위: 명) 모집인원 (1: 추첨식 2: 선착순) 상세화면 주소 시간 신청가능인원(단위: 명) 신청가능지역 (참고자료 첨부파일 내 '지역 코드정보' 시트 참고) 신청대상 (참고자료 첨부파일 내 '신청대상 코드정보' 시트 참고) 신청인원(단위: 명) 예약상태 (REQST: 접수중 END: 마감 PREV: 예정) WAIT: 대기접수 CRSE: 확인 운영시작일 운영종료일 응답자료형식 전체 결과 수 접수시작일 접수유형 (A: 온라인 B: 집합) 접수종료일 체험기간순번 체험대상 (참고자료 첨부파일 내 '체험_교육_공연대상 코드정보' 시트 참고) 체험대상 상세 체험명 체험순번 추첨인원(단위: 명) onlineRceptCd: 1(추첨식)인 경우 사용 페이지 번호 프로그램 등록날짜 프로그램 수정날짜 프로그램 제목 한 페이지 결과 수 한 페이지내 번호

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '검색어 : 공연대분류명 또는 공연명=값' \
  --data-urlencode '검색어 : 교육대분류명 또는 교육명=값' \
  --data-urlencode '검색어 : 체험대분류명 또는 체험명=값' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '공연 카테고리 대분류 시퀀스=값' \
  --data-urlencode '교육 구분 : instt (교육연수)=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "검색어 : 공연대분류명 또는 공연명": "값",
  "검색어 : 교육대분류명 또는 교육명": "값",
  "검색어 : 체험대분류명 또는 체험명": "값",
  "공공데이터포털에서 받은 인증키": "값",
  "공연 카테고리 대분류 시퀀스": "값",
  "교육 구분 : instt (교육연수)": "값",
});

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": "발급받은_인증키",
    "검색어 : 공연대분류명 또는 공연명": "값",
    "검색어 : 교육대분류명 또는 교육명": "값",
    "검색어 : 체험대분류명 또는 체험명": "값",
    "공공데이터포털에서 받은 인증키": "값",
    "공연 카테고리 대분류 시퀀스": "값",
    "교육 구분 : instt (교육연수)": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())