🎒 오늘시간표 앱의 운영 인프라 그대로 개방

학교 가정통신문과 급식 사진,
API 한 줄로 받아오세요

학교 홈페이지 크롤러를 직접 만들지 마세요. NEIS 학교 코드만 넘기면 가정통신문 목록·본문·첨부파일과 실제 급식 사진을 JSON으로 드립니다. 전국 대부분의 교육청 학교 홈페이지를 지원해요.

API 문서 보기 →
가입 절차 없음 · 하루 1,000회 무료 · 신용카드 불필요
# 가정통신문 목록
$ curl "…/api/v1/notices?officeCode=J10&schoolCode=7611009" \
    -H "X-API-Key: YOUR_KEY"

{
  "notices": [{
    "title": "여름방학 안내 가정통신문",
    "date": "2026.07.13",
    "writer": "교무부",
    "files": [{ "name": "안내문.hwp", "url": "https://…" }]
  }]
}
Features

크롤러 없이, 바로 데이터

교육청 표준 홈페이지의 세션 처리·게시판 탐지·파싱을 서버가 전부 대신합니다.

📄

가정통신문 목록 + 본문

제목·날짜·작성자·게시판·본문·이미지까지 구조화된 JSON으로 제공합니다.

📎

첨부파일 포함

목록 응답에 hwp·pdf 첨부파일 다운로드 링크가 바로 들어 있습니다.

🍚

실제 급식 사진

영양사님이 학교 홈페이지에 올린 그날의 실제 급식 사진과 메뉴를 제공합니다.

⚡️

24시간 캐시

같은 학교 요청은 캐시로 즉시 응답. 학교 서버에 부담도 주지 않습니다.

🔑

3초 키 발급

카카오 로그인 한 번이면 끝. 별도 심사나 대기 없이 바로 호출할 수 있습니다.

🆓

무료 1,000회/일

키당 하루 1,000회 무료입니다. 캐시 응답이라 대부분의 서비스에 충분합니다.

Quick Start

3분이면 첫 호출까지

키 발급 → 학교 코드 확인 → 호출. 이게 전부입니다.

1

API 키 발급

아래에서 카카오 로그인으로 키를 발급받으세요. 계정당 1개, 언제든 다시 확인할 수 있어요.

2

NEIS 학교 코드 확인

NEIS 학교기본정보의 시도교육청코드(officeCode)와 행정표준코드(schoolCode)를 찾으세요.

3

호출

X-API-Key 헤더를 붙여 GET 요청 한 번이면 JSON이 돌아옵니다.

BASE="https://api.onultime.com"

# 가정통신문 (작성자·첨부 포함)
curl "$BASE/v1/notices?officeCode=J10&schoolCode=7611009" -H "X-API-Key: $KEY"

# 급식 사진
curl "$BASE/v1/meals/photos?officeCode=J10&schoolCode=7611009&date=2026-07-17" -H "X-API-Key: $KEY"

API 키 발급

카카오 로그인 한 번으로 바로 발급됩니다.
이미 발급받았다면 기존 키를 다시 보여드려요.

키가 유출됐거나 새로 받고 싶으면 재발급하세요. 옛 키는 즉시 무효가 돼요.

API 레퍼런스

전체 엔드포인트, 파라미터, 응답 스키마, 에러 코드를 확인하세요.

문서 보러 가기 →