API Documentation

Complete reference for the Learning Tracker API. Explore endpoints, test requests, and integrate with your applications.

API Health Check
RESTful API

Standard REST API with JSON responses. All endpoints follow consistent patterns and conventions.

Rate Limited

Protected with rate limiting: 100 req/min public, 60 req/min authenticated, 20 req/min writes.

Type Safe

TypeScript SDK available with full type definitions and auto-completion support.

Authentication
How to authenticate with the API

Session Authentication

The API uses NextAuth.js session cookies for authentication. Admin-only endpoints require authentication.

next-auth.session-token

Public Endpoints

Most read endpoints are public and don't require authentication:

  • GET /api/notion/posts - Blog posts
  • GET /api/rss - RSS feed
  • GET /api/health - Health check

Admin-Only Endpoints

The following endpoints require admin authentication:

  • GET /api/notion/entries - All entries
  • GET /api/notion/entries/[date] - Single entry
  • PUT /api/notion/entries/[date] - Update entry
  • DELETE /api/notion/entries/[date] - Delete entry
  • GET /api/notion/stats - Statistics
Interactive API Explorer
Try out API endpoints directly from your browser

Additional Resources

TypeScript SDK

Use our type-safe TypeScript SDK for seamless API integration.

npm install @learning-tracker/sdk
API Changelog

Track API changes, deprecations, and new features.

View Changelog