REST API

TodoMate REST API를 사용하면 모든 HTTP 클라이언트에서 할 일, 목표, 비전을 관리할 수 있습니다. 이 가이드는 토큰을 얻고 curl로 첫 번째 요청을 보내는 방법을 안내합니다.

사전 요구사항

• todo.ac 계정 (GitHub으로 로그인)
• Pro 구독 — API 키 생성에 필요

1단계 — GitHub CLI 설치

GitHub 액세스 토큰을 얻는 가장 쉬운 방법은 GitHub CLI를 사용하는 것입니다.

# macOS
brew install gh

# Windows
winget install GitHub.cli

# Linux — https://github.com/cli/cli/blob/trunk/docs/install_linux.md 참조

2단계 — GitHub 액세스 토큰 얻기

gh auth login
gh auth token

출력된 토큰을 복사하세요 — 4단계에서 사용합니다.

3단계 — API 키 얻기

API 키는 클라이언트를 API에 인증합니다.

1. todo.ac 열기
2. 계정 → API 키로 이동
3. 키 생성을 탭하고 이름을 지정한 후 값 복사 — 한 번만 표시됨

4단계 — TodoMate JWT 얻기

GitHub 토큰을 단기 JWT로 교환합니다:

JWT=$(curl -s -X POST https://api.todo.ac/v1/auth/token \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: 내_API_키" \
  -d '{"github_token": "내_GitHub_토큰"}' \
  | jq -r '.access_token')

echo $JWT

참고: jq는 JSON 응답을 파싱하는 데 사용됩니다. brew install jq 또는 패키지 관리자로 설치하세요.

5단계 — 할 일 목록 조회

curl https://api.todo.ac/v1/todos \
  -H "Authorization: Bearer $JWT" \
  -H "Ocp-Apim-Subscription-Key: 내_API_키"

할 일의 JSON 배열이 반환되어야 합니다.

다음 단계

API 참조 전체를 탐색하여 사용 가능한 모든 엔드포인트(할 일, 목표, 비전 등)를 확인하세요.