Overview

View as Markdown

MovieKnight backend (Node/Express + MongoDB, TMDB and Gemini proxied server-side).

Base URL:

set {{baseUrl}} to http://localhost:3000 (dev) or the deployed Render URL - https://movieknight-server-7d8h.onrender.com (prod).

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 need Authorization: Bearer header. The collection sends {{token}} as a Bearer token by default; public routes override this with No Auth. Signup and Login save the returned token into {{token}} automatically (see their Tests tab).

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

Variables: baseUrl, token, userId, collectionId, tmdbId, personId.