API Changelog

A history of changes to the SPINES Public API.

v1.2.0

SDK, Getting Started & MCP Launch

  • +TypeScript SDK (@spines/sdk) — Stripe-style DX with resource namespaces
  • +Getting Started guide — 4-step setup with REST/MCP examples
  • +MCP server v1.0.0 — ready for public extraction and npm publish
  • +MCP discovery at /.well-known/mcp.json
  • +Code examples in curl, JavaScript, and Python
v1.1.0

Platform Polish

  • +Usage tracking — per-key, per-endpoint daily statistics
  • +OpenAPI 3.1 spec at /api/v1/openapi.json
  • +Interactive API docs via Scalar
  • +Developer portal with landing page, FAQ, and Terms
  • +Abuse detection (high error-rate blocking)
  • +Admin API monitoring dashboard
v1.0.0

Initial Release

Authentication & Security

  • +API key management (create, list, revoke)
  • +HMAC checksum verification
  • +Rate limiting (30/min burst, 1,000/day read, 200/day write)
  • +Scope-based authorization (12 scopes)
  • +Health check endpoint

Read Endpoints

  • +11 GET endpoints: collections, books, personas, categories, reading lists, profile
  • +Cursor-based pagination with configurable sorting
  • +Book search, pairings (Shelfology), and related collections

Write Endpoints

  • +6 write endpoints: create/update/delete collections, manage books, update profile
  • +Test-mode support (write to sandbox, not production)

MCP Server

  • +Model Context Protocol server with 8 tools, 4 resources, 3 prompts

Recognition

  • +Async book recognition from bookshelf images
  • +BYOK (Bring Your Own Key) for Gemini, OpenAI, Anthropic
  • +Daily credit system (3/day)