Docs

Cats API field notes

This page is the friendly lobby. The real machine-readable documentation lives in Swagger UI. If you prefer your documentation with more hairballs and less JSON, you are in the right place.

Cat facts for engineers

GET /api/v1/cats lists cats in descending ID order, which is exactly how cats prefer to be sorted: by unexplained authority.

POST /api/v1/auth/login revokes older tokens before issuing a new one, because even fictional cats deserve basic credential hygiene.

Plans matter. `stray` reads, `house_cat` writes, `lion` roars at much higher throughput.

Admin routes exist, but this page will not gossip about them to guests. Cats understand privilege boundaries.

Suggested starting path

  1. 1. Open Swagger UI to inspect the current surface.
  2. 2. Register or log in to obtain a real token flow.
  3. 3. Call the cats endpoints and verify your platform can survive payloads involving names like Sir Pounces-a-Lot.