Overview

View as Markdown

MovieKnight backend API

Base URL

Choose the server in the API Explorer: https://movieknight-server-7d8h.onrender.com (prod) or http://localhost:3000 (dev).

Base path

every route lives under /api except GET / (health).

Response envelope (all /api routes)

  • Success:
1{ 
2  "ok": true, 
3  "data": {...} 
4}
  • Error:
1{ 
2  "ok": false, 
3  "error": "message",
4  "code"?: "..."
5}

Auth

Protected routes require an Authorization: Bearer <token> header. Get a token from the POST /api/auth/signup or POST /api/auth/login response (data.token), then paste it into the API Explorer’s bearer-token field; it persists across requests. Public routes (health, signup, login, all movies / people reads, genres, providers) need no token.

Note: the docs playground does not run scripts, so the token is not captured automatically - paste it once after logging in.

Status codes used: 200, 201, 400, 401, 404, 429, 500, 502, 504.