사용 가이드 › 읽을거리
스케줄러 API로 알 수 있는 것과 없는 것
최종 수정 2026-10-12
스케줄러 API란
메이플스토리 게임 안의 스케줄러에 등록한 일일·주간 퀘스트, 콘텐츠, 보스의 진행 상황을 넥슨 Open API로 받아 볼 수 있습니다. 메이플 숙제는 이 데이터를 캐릭터별로 모아 한 화면에 보여 줍니다.
알 수 있는 것
- 스케줄러에 등록한 일일 퀘스트·주간 퀘스트의 완료 여부.
- 몬스터파크, 에픽 던전 같은 콘텐츠의 이번 주기 이용 횟수와 최대 횟수.
- 주간·월간 보스를 이번 주기에 잡았는지와 난이도. 일일·주간·월간 구분도 함께 옵니다.
- 최근 14일 안의 날짜를 정해 그날의 상태를 다시 받아 볼 수 있습니다. 그래서 사이트를 며칠 열지 않아도 지난 기록을 채울 수 있습니다.
알 수 없는 것
- 다른 사람 계정의 스케줄러. API 키를 발급한 사람 본인 계정의 캐릭터만 볼 수 있습니다.
- 14일보다 오래된 스케줄러 기록. 그 이전은 날짜별 캐릭터 경험치 변화로 "그날 플레이했는지"만 추정합니다.
- 계정이 함께 쓰는 횟수의 캐릭터별 몫. 몬스터파크는 계정 전체가 함께 쓰는 값이 모든 캐릭터에 똑같이 복사되어 오기 때문에, 어느 캐릭터가 몇 판을 돌았는지는 알 수 없습니다. 에픽 던전도 계정 단위로 몇 개를 했는지만 오고 누가 했는지는 오지 않아, 대시보드에서 직접 고를 수 있게 했습니다.
- 오늘 접속했는지. 접속하지 않은 캐릭터도 오늘 날짜로 응답이 오기 때문에 스케줄러만으로는 접속 여부를 가를 수 없습니다. 캐릭터 기본 정보의 최근 7일 접속 여부만 참고할 수 있습니다.
- 스케줄러에 등록하지 않은 숙제. 게임 안에서 등록한 항목만 응답에 들어옵니다.
갱신은 이렇게 해요
메이플 숙제는 대시보드를 열어 두면 10분마다 자동으로 새로 받아 오고, 지금 갱신 버튼으로 바로 받을 수도 있습니다. 넥슨 쪽 데이터가 게임과 몇 분 차이가 날 수 있으니, 방금 끝낸 숙제가 바로 안 보이면 잠시 뒤 다시 갱신해 보세요.
API 키는 안전한가요
입력한 API 키는 암호화해 저장하고, 내 캐릭터 조회에만 씁니다. 설정 탭에서 언제든 키를 바꾸거나 계정을 삭제할 수 있고, 삭제하면 저장된 데이터가 모두 지워집니다.