개발자 안내
재학생과 교직원은 DSHS.APP의 데이터를 활용해 앱을 만들 수 있습니다. 이 가이드에서는 앱 등록부터 로그인 연동, 첫 API 호출까지 필요한 과정을 안내합니다. API의 전체 사양은 아래의 API 문서를 참고하세요.
사용할 수 있는 기능
dshs.app 계정으로 로그인: 사용자가
id.dshs.app에서 로그인하면 앱으로 돌아오고, 앱은 토큰을 발급받습니다. "구글로 로그인"과 같은 방식으로, OpenID Connect 표준을 따릅니다. 앱에서 사용자의 비밀번호를 직접 받지 않습니다.학교 API: 로그인할 때 받은 액세스 토큰으로 내 정보, 게시판, 신청, 기숙사, 온라인 저지 등 학교 데이터를 읽고 쓸 수 있습니다.
관리자에게 앱을 Client로 등록하면 두 기능을 모두 사용할 수 있습니다.
신청 대상
Client 발급은 재학생과 교직원이 신청할 수 있습니다. 관리자가 신청 내용을 검토하며, 검토 결과에 따라 발급이 거절될 수 있습니다.
API 문서
문서 | 주요 내용 |
|---|---|
로그인, 토큰 발급·갱신, 권한 동의, 로그아웃. 모든 학교가 같은 인증 서버를 사용합니다. | |
대전과학고등학교 API의 전체 경로, 필요한 권한(Scope), 요청·응답 형식. |
학교 API의 기본 주소는 학교마다 다릅니다. 이 가이드에서는 대전과학고등학교의 주소인 https://api.dshs.app을 사용합니다.
이용 규칙
시작하기
Client 발급받기: 관리자에게 앱 등록을 신청합니다.
dshs.app 로그인 연동: 앱에 로그인을 연동하고 토큰을 발급받습니다.
학교 API 사용하기: 액세스 토큰으로 API를 호출합니다.
문제 해결: 연동 중 오류가 발생하면 원인과 해결 방법을 확인합니다.