DataGSM OpenAPI SDK Overview

// ✅ SDK 사용 - 컴파일 타임에 타입 체크
StudentResponse students = client.students().getStudents(
    new StudentApi.StudentRequest()
        .grade(1)
        .classNum(1)
);
Student firstStudent = students.getStudents().get(0);
String name = firstStudent.getName(); // 타입 안전하며 IDE 자동완성 지원

// ❌ 직접 HTTP 호출 - 런타임 오류 가능성
JSONObject response = makeHttpRequest(...);
String name = response.getJSONArray("students")
    .getJSONObject(0)
    .getString("name"); // 오타나 구조 변경 시 런타임 에러 발생

// ✅ SDK 사용 - 구체적인 예외 타입으로 명확한 에러 처리
try {
    StudentResponse students = client.students().getStudents(request);
} catch (UnauthorizedException e) {
    // 401 - API 키 갱신 필요
    log.error("API key expired", e);
    renewApiKey();
} catch (RateLimitException e) {
    // 429 - Rate limit 초과, 재시도 로직
    log.warn("Rate limit exceeded, retrying...", e);
    retryAfter(e.getRetryAfter());
} catch (DataGsmException e) {
    // 기타 API 오류
    log.error("API error: {}", e.getMessage());
}

// ❌ 직접 HTTP 호출 - 수동으로 상태 코드 파싱 필요
if (response.statusCode() == 401) {
    // 인증 오류 처리
} else if (response.statusCode() == 429) {
    // Rate limit 처리
} else if (response.statusCode() >= 500) {
    // 서버 오류 처리
}

// ✅ SDK 사용 - 단 3줄로 API 호출 완료
DataGsmClient client = DataGsmClient.builder("your-api-key").build();
List<Meal> meals = client.neis().getMeals(
    new NeisApi.MealRequest()
        .date(LocalDate.now())
);

// ❌ 직접 HTTP 호출 - 많은 보일러플레이트 코드 필요
HttpClient httpClient = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datagsm.com/v1/neis/meals?date=2025-01-02"))
    .header("X-API-KEY", "your-api-key")
    .GET()
    .build();
HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());
ObjectMapper mapper = new ObjectMapper();
List<Meal> meals = mapper.readValue(response.body(), new TypeReference<List<Meal>>(){});
// + 에러 처리, 리소스 정리 등 추가 코드 필요

// 모든 API가 동일한 패턴을 따름
StudentResponse students = client.students().getStudents(request);
ClubResponse clubs = client.clubs().getClubs(request);
ProjectResponse projects = client.projects().getProjects(request);
List<Meal> meals = client.neis().getMeals(request);