API Operations Playbook #15

Code Example

import express from "express";

const app = express();
app.use(express.json());

app.get("/health", (_req, res) => {
  res.status(200).json({
    status: "ok",
    service: "backend-api-mastery",
    objective: "increase test confidence",
  });
});

app.post("/orders/preview", (req, res) => {
  const { items = [] } = req.body as { items?: Array<{ qty: number; price: number }> };
  const total = items.reduce((sum, item) => sum + item.qty * item.price, 0);
  return res.status(200).json({ scenario: "admin operations backend", total });
});

app.listen(3000, () => console.log("Run:", "app.get('/route', handler)"));

Commands & References

• app.get('/route', handler)
• npm init -y
• npm run dev

Lab Steps

1. Prepare environment using: app.get('/route', handler)
2. Implement endpoint or middleware for this scenario.
3. Test positive/negative cases and inspect response contracts.
4. Document one reliability or security improvement.

Exercises

• Add one edge-case validation and return clear error details.
• Improve one endpoint to be idempotent and test retries.
• Write one test case proving the expected API behavior.