DataGSM OpenAPI SDK Python

from datagsm_openapi import DataGsmClient

# 기본 설정으로 클라이언트 생성
with DataGsmClient(api_key="your-api-key-here") as client:
    # API 사용
    pass

# 커스텀 Base URL 설정 (선택사항)
with DataGsmClient(
    api_key="your-api-key-here",
    base_url="https://api.datagsm.com"
) as client:
    # API 사용
    pass

from datagsm_openapi import DataGsmClient
from datagsm_openapi.api.student import StudentRequest

# 요청 파라미터 설정
request = StudentRequest(
    grade=1,  # 1학년
    class_num=1,  # 1반
    page=0,  # 첫 번째 페이지
    size=50  # 페이지당 50명
)

with DataGsmClient(api_key="your-api-key") as client:
    # API 호출
    response = client.students.get_students(request)

    # 결과 처리
    for student in response.students:
        print(f"{student.name} - {student.email}")

from datagsm_openapi import DataGsmClient
from datagsm_openapi.api.neis import MealRequest
from datetime import date

# 오늘 날짜의 급식 조회
request = MealRequest(date=date.today())

with DataGsmClient(api_key="your-api-key") as client:
    meals = client.neis.get_meals(request)

    # 급식 데이터 출력
    for meal in meals:
        print(f"{meal.meal_type}:")
        for menu in meal.meal_menu:
            print(f" - {menu}")

# 학생 목록 조회
students = client.students.get_students(request)

# 특정 학생 조회
student = client.students.get_student(1)

# 동아리 목록 조회
clubs = client.clubs.get_clubs(request)

# 특정 동아리 조회
club = client.clubs.get_club(1)

# 프로젝트 목록 조회
projects = client.projects.get_projects(request)

# 특정 프로젝트 조회
project = client.projects.get_project(1)

# 급식 데이터 조회
meals = client.neis.get_meals(request)

# 학사일정 조회
schedules = client.neis.get_schedules(request)

import logging
from datagsm_openapi import DataGsmClient
from datagsm_openapi.exceptions import (
    UnauthorizedException,
    ForbiddenException,
    RateLimitException,
    BadRequestException,
    ServerErrorException,
    DataGsmException
)

logger = logging.getLogger(__name__)

try:
    with DataGsmClient(api_key="your-api-key") as client:
        students = client.students.get_students(request)
        # 성공적인 응답 처리
except UnauthorizedException as e:
    # API 키 갱신 필요
    logger.error("API key expired or invalid", exc_info=e)
    renew_api_key()
except ForbiddenException as e:
    # 권한 범위 부족
    logger.warning("Insufficient permissions", exc_info=e)
    notify_user_about_permissions()
except RateLimitException as e:
    # Rate limit 초과 - 적절한 재시도 로직 구현 필요
    logger.warning("Rate limit exceeded", exc_info=e)
    # 실제로는 exponential backoff 등의 재시도 전략 구현 권장
except BadRequestException as e:
    # 잘못된 요청 파라미터
    logger.error(f"Invalid request parameters: {e.message}")
    validate_parameters()
except ServerErrorException as e:
    # 서버 오류
    logger.error("Server error occurred", exc_info=e)
    notify_admin()
except DataGsmException as e:
    # 기타 예외
    logger.error(f"API error: {e.message}", exc_info=e)

# with문을 사용한 자동 리소스 관리
with DataGsmClient(api_key="your-api-key") as client:
    students = client.students.get_students(request)
    # 클라이언트 사용
# 블록이 끝나면 자동으로 리소스 정리

export DATAGSM_API_KEY="your-api-key-here"
export DATAGSM_BASE_URL="https://openapi.data.hellogsm.kr"  # 선택사항

from datagsm_openapi import DataGsmClient
from datagsm_openapi.api.student import StudentRequest
from datagsm_openapi.api.neis import MealRequest
from datagsm_openapi.exceptions import (
    UnauthorizedException,
    RateLimitException,
    DataGsmException
)
from datetime import date

def main():
    # with문으로 자동 리소스 관리
    try:
        with DataGsmClient(api_key="your-api-key-here") as client:

            # 학생 데이터 조회
            students_response = client.students.get_students(
                StudentRequest(grade=1, class_num=1, size=10)
            )

            # 결과 출력
            for student in students_response.students:
                print(f"{student.name} ({student.student_number}) - {student.email}")

            # 급식 데이터 조회
            meals = client.neis.get_meals(
                MealRequest(date=date.today())
            )

            # 급식 출력
            for meal in meals:
                print(f"{meal.meal_type}:")
                for menu in meal.meal_menu:
                    print(f"  - {menu}")

    except UnauthorizedException as e:
        print("인증 오류: API 키가 유효하지 않습니다.")
        print(e)
    except RateLimitException as e:
        print("요청 제한 초과: 잠시 후 다시 시도해주세요.")
        print(e)
    except DataGsmException as e:
        print(f"API 오류 발생: {e.message}")
        print(e)
    except Exception as e:
        print(f"예상치 못한 오류 발생: {e}")
        raise

if __name__ == "__main__":
    main()

import os
from datagsm_openapi import DataGsmClient

def main():
    # 환경 변수에서 API 키 로드
    api_key = os.getenv("DATAGSM_API_KEY")

    if not api_key:
        raise ValueError("환경 변수 DATAGSM_API_KEY가 설정되지 않았습니다.")

    with DataGsmClient(api_key=api_key) as client:
        # API 사용
        pass

if __name__ == "__main__":
    main()

export DATAGSM_API_KEY="your-api-key-here"
python main.py

$env:DATAGSM_API_KEY="your-api-key-here"
python main.py