DataGSM OpenAPI SDK for .NET

using Datagsm.OpenApi;

// 기본 설정으로 클라이언트 생성 (using으로 자동 리소스 관리)
using var client = new DataGsmClient("your-api-key-here");

// 커스텀 Base URL 설정 (선택사항)
using var clientWithCustomUrl = new DataGsmClient(
    apiKey: "your-api-key-here",
    baseUrl: "https://api.datagsm.com" // 설정하지 않는다면 공식 Base URL 사용
);

using Datagsm.OpenApi;
using Datagsm.OpenApi.Models;

// 요청 파라미터 설정
var request = new StudentRequest
{
    Grade = 1,    // 1학년
    ClassNum = 1, // 1반
    Page = 0,     // 첫 번째 페이지
    Size = 50     // 페이지당 50명
};

using var client = new DataGsmClient("your-api-key");

// API 호출
var response = await client.Students.GetStudentsAsync(request);

// 결과 처리
foreach (var student in response.Students)
{
    Console.WriteLine($"{student.Name} - {student.Email}");
}

using Datagsm.OpenApi;

using var client = new DataGsmClient("your-api-key");

// 오늘 날짜의 급식 조회
var meals = await client.Neis.GetMealsAsync();

// 급식 데이터 출력
foreach (var meal in meals)
{
    Console.WriteLine($"{meal.MealType}:");
    foreach (var menu in meal.MealMenu)
    {
        Console.WriteLine($" - {menu}");
    }
}

// 학생 목록 조회
var students = await client.Students.GetStudentsAsync(request);

// 특정 학생 조회
var student = await client.Students.GetStudentAsync(1);

// 전공 동아리 목록 조회
var clubs = await client.Clubs.GetClubsAsync(new ClubRequest
{
    ClubType = ClubType.MajorClub
});

// 특정 동아리 조회
var club = await client.Clubs.GetClubAsync(1);

// 프로젝트 목록 조회
var projects = await client.Projects.GetProjectsAsync();

// 특정 프로젝트 조회
var project = await client.Projects.GetProjectAsync(1);

// 오늘의 급식 조회
var meals = await client.Neis.GetMealsAsync();

// 학사일정 범위 조회
var schedules = await client.Neis.GetSchedulesAsync(new ScheduleRequest
{
    FromDate = new DateOnly(2025, 3, 1),
    ToDate   = new DateOnly(2025, 3, 31)
});

using Datagsm.OpenApi;
using Datagsm.OpenApi.Exceptions;
using Microsoft.Extensions.Logging;

try
{
    var students = await client.Students.GetStudentsAsync(request);
    // 성공적인 응답 처리
}
catch (UnauthorizedException e)
{
    // API 키 갱신 필요
    logger.LogError(e, "API key expired or invalid");
    await RenewApiKeyAsync();
}
catch (ForbiddenException e)
{
    // 권한 범위 부족
    logger.LogWarning(e, "Insufficient permissions");
    NotifyUserAboutPermissions();
}
catch (RateLimitException e)
{
    // Rate limit 초과 - 적절한 재시도 로직 구현 필요
    logger.LogWarning(e, "Rate limit exceeded");
    // 실제로는 exponential backoff 등의 재시도 전략 구현 권장
}
catch (BadRequestException e)
{
    // 잘못된 요청 파라미터
    logger.LogError("Invalid request parameters: {Message}", e.Message);
    ValidateParameters();
}
catch (ServerErrorException e)
{
    // 서버 오류
    logger.LogError(e, "Server error occurred");
    NotifyAdmin();
}
catch (DataGsmException e)
{
    // 기타 예외
    logger.LogError(e, "API error: {Message}", e.Message);
}

// using 선언 - 현재 스코프가 끝날 때 자동으로 리소스 정리
using var client = new DataGsmClient("your-api-key");
var students = await client.Students.GetStudentsAsync(request);
// 메서드가 끝나면 자동으로 리소스 정리

// using 블록 - 블록이 끝날 때 자동으로 리소스 정리
using (var client = new DataGsmClient("your-api-key"))
{
    var students = await client.Students.GetStudentsAsync(request);
    // 블록이 끝나면 자동으로 리소스 정리
}

// Program.cs
using Datagsm.OpenApi;

var builder = WebApplication.CreateBuilder(args);

// appsettings.json 또는 환경 변수에서 API 키 로드
var apiKey = builder.Configuration["DataGsm:ApiKey"]
    ?? throw new InvalidOperationException("DataGsm:ApiKey is not configured.");

// 싱글톤으로 등록 (HttpClient 재사용을 위해 권장)
builder.Services.AddSingleton(new DataGsmClient(apiKey));

var app = builder.Build();

// appsettings.json
{
  "DataGsm": {
    "ApiKey": "" // 실제 키는 환경 변수나 Secret Manager로 관리하세요
  }
}

# 환경 변수로 설정 (권장)
DataGsm__ApiKey=your-api-key-here

using Datagsm.OpenApi;
using Datagsm.OpenApi.Models;

public class SchoolDataService
{
    private readonly DataGsmClient _dataGsmClient;

    public SchoolDataService(DataGsmClient dataGsmClient)
    {
        _dataGsmClient = dataGsmClient;
    }

    public async Task<IList<Student>> GetStudentsByClassAsync(int grade, int classNum)
    {
        var response = await _dataGsmClient.Students.GetStudentsAsync(new StudentRequest
        {
            Grade = grade,
            ClassNum = classNum,
            Size = 50
        });
        return response.Students;
    }
}

using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class StudentsController : ControllerBase
{
    private readonly SchoolDataService _schoolDataService;

    public StudentsController(SchoolDataService schoolDataService)
    {
        _schoolDataService = schoolDataService;
    }

    [HttpGet]
    public async Task<IActionResult> GetStudents([FromQuery] int grade, [FromQuery] int classNum)
    {
        var students = await _schoolDataService.GetStudentsByClassAsync(grade, classNum);
        return Ok(students);
    }
}

using Datagsm.OpenApi;
using Datagsm.OpenApi.Models;
using Datagsm.OpenApi.Exceptions;

class Program
{
    static async Task Main(string[] args)
    {
        // 환경 변수에서 API 키 로드
        var apiKey = Environment.GetEnvironmentVariable("DATAGSM_API_KEY")
            ?? throw new InvalidOperationException("DATAGSM_API_KEY 환경 변수가 설정되지 않았습니다.");

        // using으로 자동 리소스 관리
        using var client = new DataGsmClient(apiKey);

        try
        {
            // 학생 데이터 조회
            var students = await client.Students.GetStudentsAsync(new StudentRequest
            {
                Grade = 1,
                ClassNum = 1,
                Size = 10
            });

            // 결과 출력
            foreach (var student in students.Students)
            {
                Console.WriteLine($"{student.Name} ({student.StudentNumber}) - {student.Email}");
            }

            // 급식 데이터 조회
            var meals = await client.Neis.GetMealsAsync();

            // 급식 출력
            foreach (var meal in meals)
            {
                Console.WriteLine($"{meal.MealType}:");
                foreach (var menu in meal.MealMenu)
                {
                    Console.WriteLine($"  - {menu}");
                }
            }

            // 학사일정 조회
            var schedules = await client.Neis.GetSchedulesAsync(new ScheduleRequest
            {
                FromDate = new DateOnly(2025, 3, 1),
                ToDate   = new DateOnly(2025, 3, 31)
            });

            foreach (var schedule in schedules)
            {
                Console.WriteLine($"{schedule.Date}: {schedule.EventName}");
            }
        }
        catch (UnauthorizedException)
        {
            Console.Error.WriteLine("인증 오류: API 키가 유효하지 않습니다.");
        }
        catch (RateLimitException)
        {
            Console.Error.WriteLine("요청 제한 초과: 잠시 후 다시 시도해주세요.");
        }
        catch (DataGsmException e)
        {
            Console.Error.WriteLine($"API 오류 발생: {e.Message}");
        }
    }
}

// 환경 변수에서 API 키 로드
var apiKey = Environment.GetEnvironmentVariable("DATAGSM_API_KEY");

if (string.IsNullOrEmpty(apiKey))
{
    Console.Error.WriteLine("환경 변수 DATAGSM_API_KEY가 설정되지 않았습니다.");
    Environment.Exit(1);
}

using var client = new DataGsmClient(apiKey);
// API 사용

export DATAGSM_API_KEY="your-api-key-here"
dotnet run

$env:DATAGSM_API_KEY="your-api-key-here"
dotnet run

dotnet user-secrets init
dotnet user-secrets set "DataGsm:ApiKey" "your-api-key-here"