# GitHub API로 커밋 히스토리 불러오기 (Spring Boot REST API 연동)

 

이런 커밋 히스토리를 가져와서 포트폴리오 사이트에 뿌려주고 싶었다.

 

완성 화면

 

해당 기능은 GitHub API로 히스토리를 불러올 수 있다.

필요한 기능 : GitHub API 엔드포인트, Access Token 발급

---

1. GitHub API 소개

• GitHub은 REST API를 제공하고, repos 엔드포인트를 이용하면 커밋 히스토리를 조회할 수 있다.
• 기본 주소:

https://api.github.com/repos/{owner}/{repo}/commits

---

2. Personal Access Token 발급

1. GitHub 로그인 → Settings → Developer settings → Personal access tokens
2. Fine-grained token 또는 Classic token 발급
3. 최소 권한은 repo → contents:read 정도면 충분

주의: 토큰은 절대 공개 저장소에 올리면 안됨.

 

가장 간단한 방법은 javascript로 API를 요청하면 되지만,

우리는 토큰이 있기 때문에 서비스를 만들어서 가져오려고 합니다.

RestTemplate이나 WebClient로 구현 가능하지만, 여기서는 간단하게 RestTemplate으로 하겠습니다.

---

1.Service 클래스

@Service
public class GitHubService {

    private final RestTemplate restTemplate = new RestTemplate();
    private static final String GITHUB_API_URL = "https://api.github.com/repos/{owner}/{repo}/commits";

    public String getCommits(String owner, String repo, String token) {
        HttpHeaders headers = new HttpHeaders();
        headers.set("Authorization", "token " + token);
        headers.set("Accept", "application/vnd.github+json");

        HttpEntity<String> entity = new HttpEntity<>(headers);

        ResponseEntity<String> response = restTemplate.exchange(
                GITHUB_API_URL,
                HttpMethod.GET,
                entity,
                String.class,
                owner,
                repo
        );

        return response.getBody();
    }
}

---

2.Controller 클래스

@RestController
@RequestMapping("/github")
public class GitHubController {

    private final GitHubService gitHubService;

    public GitHubController(GitHubService gitHubService) {
        this.gitHubService = gitHubService;
    }

    @GetMapping("/commits/{owner}/{repo}")
    public String getCommits(
            @PathVariable String owner,
            @PathVariable String repo,
            @RequestHeader("Authorization") String token
    ) {
        // token은 "Bearer xxx" 말고 "token xxx" 형식으로 보내야 함
        return gitHubService.getCommits(owner, repo, token.replace("token ", ""));
    }
}

---

3.사용 방법

1. 서버 실행

2. API 호출 (Postman이나 브라우저에서)

curl -H "Authorization: token {YOUR_GITHUB_TOKEN}" \
http://localhost:8080/github/commits/{owner}/{repo}

---

3.결과: GitHub에서 내려주는 JSON이 그대로 출력됨

[
  {
    "sha": "a1b2c3...",
    "commit": {
      "author": {
        "name": "홍길동",
        "email": "hong@test.com",
        "date": "2025-08-27T05:21:20Z"
      },
      "message": "Fix bug in login"
    },
    "html_url": "https://github.com/owner/repo/commit/a1b2c3"
  }
]

👉 이렇게 하면 웹 사이트에 Spring Boot 기반 GitHub API 연동이 가능하다.

 

또한 이 데이터를 프론트엔드(React, Vue 등)에서 받아와서 타임라인 형태로 표현할 수 있다.

특정 브랜치만 조회하거나 (?sha=브랜치명), 특정 파일에 대한 커밋 기록만 불러올 수도 있다(?path=파일명)

포트폴리오 사이트뿐만 아니라, 팀프로젝트 기록 관리, 최근 작업 현황 페이지 같은곳에도 응용할 수 있다.