REST API

REST API của TodoMate cho phép bạn quản lý công việc, mục tiêu và tầm nhìn từ bất kỳ HTTP client nào. Hướng dẫn này giải thích cách lấy token và thực hiện yêu cầu đầu tiên bằng curl.

Yêu cầu

• Tài khoản trên todo.ac (đăng nhập bằng GitHub)
• Gói Pro — cần thiết để tạo API key

Bước 1 — Cài đặt GitHub CLI

Cách dễ nhất để lấy GitHub access token là dùng GitHub CLI.

# macOS
brew install gh

# Windows
winget install GitHub.cli

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

Bước 2 — Lấy GitHub access token

gh auth login
gh auth token

Sao chép token được in ra — bạn sẽ dùng nó ở Bước 4.

Bước 3 — Lấy API key của bạn

API key xác thực client của bạn với API.

1. Mở todo.ac
2. Vào Tài khoản → API Keys
3. Nhấn Tạo key, đặt tên và sao chép giá trị — chỉ hiển thị một lần

Bước 4 — Lấy JWT TodoMate

Đổi GitHub token của bạn lấy JWT ngắn hạn:

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

echo $JWT

Lưu ý: jq được dùng để phân tích cú pháp JSON response. Cài đặt với brew install jq hoặc trình quản lý gói của bạn.

Bước 5 — Liệt kê công việc của bạn

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

Bạn sẽ nhận được mảng JSON chứa các công việc của mình.

Bước tiếp theo

Khám phá Tài liệu API đầy đủ để xem tất cả các endpoint có sẵn — công việc, mục tiêu, tầm nhìn và nhiều hơn nữa.