NEIS API

대한민국 교육청 산하 교육기관의 급식, 학사일정 API를 이용하기 위한 Flutter용 패키지입니다.

사용법

시작하기

pubspec.yaml에 패키지를 추가합니다.

dependencies:
    ...
    neis_api:

학교 클래스 객체 생성

final school = School(region:Region, code:String);

region 은 시도교육청 코드, code 는 학교코드입니다. 학교코드는 여기에서 검색 가능합니다. School 객체를 생성합니다.

월간 급식 불러오기

final meals = await school.getMonthlyMeal(year:int, month:int);

Future<List<Meal>> 를 반환합니다. meals의 인덱스는 (불러오려는 일수) - 1 입니다. ex) 5일 => meals[5 - 1]

월간 학사일정 불러오기

final day = DateTime.now().day;
final schedules = await school.getMonthlySchedule(year:int, month:int);
debugPrint(schedules[day - 1].schedules);

Future<List<Schedule>> 를 반환합니다. schedules의 인덱스는 (불러오려는 일수) - 1 입니다. ex) 5일 => schedules[5 - 1]

시도교육청 코드

Region.CHUNGBUK과 같은 형태로 입력합니다.

교육청명반환값
Region.SEOUL서울특별시교육청B10
Region.BUSAN부산광역시교육청C10
Region.DAEGU대구광역시교육청D10
Region.INCHEON인천광역시교육청E10
Region.GWANGJU광주광역시교육청F10
Region.DAEJEON대전광역시교육청G10
Region.ULSAN울산광역시교육청H10
Region.SEJONG세종특별자치시교육청I10
Region.GYEONGGI경기도교육청J10
Region.GANGWON강원도교육청K10
Region.CHUNGBUK충청북도교육청M10
Region.CHUNGNAM충청남도교육청N10
Region.JEONBUK전라북도교육청P10
Region.JEONNAM전라남도교육청Q10
Region.GYEONGBUK경상북도교육청R10
Region.GYEONGNAM경상남도교육청S10
Region.JEJU제주특별자치도교육청T10
Region.FORIENGER재외한국학교교육청V10

예제

급식

// 4월 1일 조식 가져오기
final school = School(Region.CHUNGBUK, '8000376');
final meals = await school.getMonthlyMeal(2021, 4);
debugPrint(meals[0].breakfast);
// 예시 출력: '달걀햄야채볶음밥\n종합어묵국\n소시지구이+케첩\n배추김치\n초코우유'

학사일정

// 1월 1일 학사일정 가져오기
final school = School(Region.CHUNGBUK, '8000376');
final schedules = await school.getMonthlySchedule(2021, 1);
debugPrint(schedules[0].schedule);
// 예시 출력: '신정'

UI 적용 예제는 example 폴더를 참고해주세요.

Libraries

datautils
meal
schedule
school