DataGSM OpenAPI SDK for Go

go get github.com/jihoonwjj/datagsm-openapi-sdk-go

package main

import (
    "context"
    "fmt"
    "log"

    datagsm "github.com/jihoonwjj/datagsm-openapi-sdk-go"
)

func main() {
    client, err := datagsm.NewClient("your-api-key")
    if err != nil {
        log.Fatal(err)
    }
    defer client.Close()

    ctx := context.Background()

    resp, err := client.Students().List(ctx, datagsm.StudentQuery{
        Grade: datagsm.Ptr(1),
        Page:  0,
        Size:  20,
    })
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("학생 수: %d명\n", resp.TotalElements)
    for _, s := range resp.Students {
        fmt.Printf("  %s (%d학년 %d반)\n", s.Name, s.Grade, s.ClassNum)
    }
}

import "time"

client, err := datagsm.NewClient("your-api-key",
    datagsm.WithBaseURL("https://openapi.datagsm.kr"), // 기본값
    datagsm.WithTimeout(10 * time.Second),             // 기본값: 30초
    datagsm.WithHTTPClient(myHTTPClient),              // 커스텀 http.Client 주입
)

// 학생 목록 조회 (2학년, AI 전공)
resp, err := client.Students().List(ctx, datagsm.StudentQuery{
    Grade:   datagsm.Ptr(2),
    Major:   datagsm.Ptr(datagsm.MajorAI),
    SortBy:  datagsm.StudentSortByName,
    SortDir: datagsm.SortDirASC,
    Page:    0,
    Size:    50,
})

// 학생 단건 조회
student, err := client.Students().Get(ctx, 123)

// 오늘 급식
today := time.Now()
meals, err := client.NEIS().Meals(ctx, datagsm.MealQuery{Date: &today})

// 결과 출력
for _, meal := range meals {
    fmt.Printf("[%s]\n", meal.MealType)
    for _, menu := range meal.MealMenu {
        fmt.Printf("  - %s\n", menu)
    }
}

// 학사일정 조회
from := time.Date(2026, 3, 1, 0, 0, 0, 0, time.Local)
to   := time.Date(2026, 3, 31, 0, 0, 0, 0, time.Local)
schedules, err := client.NEIS().Schedules(ctx, datagsm.ScheduleQuery{
    FromDate: &from,
    ToDate:   &to,
})

// 시간표 조회 (Grade, ClassNum 필수)
timetables, err := client.NEIS().Timetables(ctx, datagsm.TimetableQuery{
    Grade:    2,
    ClassNum: 3,
    Date:     datagsm.Ptr(time.Now()),
})

import "errors"

resp, err := client.Students().List(ctx, query)
if err != nil {
    var apiErr *datagsm.APIError
    if errors.As(err, &apiErr) {
        switch apiErr.StatusCode {
        case 401:
            fmt.Println("API 키가 유효하지 않거나 만료되었습니다")
        case 403:
            fmt.Println("권한이 없습니다. API 키의 권한 범위를 확인하세요")
        case 429:
            fmt.Println("요청 속도 제한 초과. 잠시 후 재시도하세요")
        default:
            fmt.Printf("API 오류 %d: %s\n", apiErr.StatusCode, apiErr.Message)
        }
    } else {
        fmt.Println("네트워크 오류:", err)
    }
}

datagsm.Ptr(1)       // *int
datagsm.Ptr("hello") // *string
datagsm.Ptr(true)    // *bool

# .env
DATAGSM_API_KEY=your_secret_api_key

import "os"

client, err := datagsm.NewClient(os.Getenv("DATAGSM_API_KEY"))