Lewati ke konten utama

REST API

REST API TodoMate memungkinkan Anda mengelola tugas, tujuan, dan visi dari klien HTTP mana pun. Panduan ini menjelaskan cara mendapatkan token dan membuat permintaan pertama menggunakan curl.

Prasyarat​

  • Akun di todo.ac (masuk dengan GitHub)
  • Langganan Pro — diperlukan untuk membuat kunci API

Langkah 1 — Instal GitHub CLI​

Cara termudah mendapatkan token akses GitHub adalah dengan GitHub CLI.

# macOS
brew install gh

# Windows
winget install GitHub.cli

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

Langkah 2 — Dapatkan token akses GitHub​

gh auth login
gh auth token

Salin token yang ditampilkan — Anda membutuhkannya di Langkah 4.

Langkah 3 — Dapatkan kunci API Anda​

Kunci API mengautentikasi klien Anda ke API.

  1. Buka todo.ac
  2. Buka Akun → Kunci API
  3. Ketuk Buat kunci, beri nama, dan salin nilainya — hanya ditampilkan sekali

Langkah 4 — Dapatkan JWT TodoMate​

Tukarkan token GitHub Anda dengan JWT berumur pendek:

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

echo $JWT

Catatan: jq digunakan untuk memproses respons JSON. Instal dengan brew install jq atau pengelola paket Anda.

Langkah 5 — Daftar tugas Anda​

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

Anda akan menerima array JSON berisi tugas-tugas Anda.

Langkah selanjutnya​

Jelajahi Referensi API lengkap untuk melihat semua endpoint yang tersedia — tugas, tujuan, visi, dan lainnya.