API Reference & Postman Setup

HTTP Status Codes Reference

This API uses standard HTTP status codes. Knowing these is essential for both testing and interviews.

Response Format

Every response follows a consistent format. Success responses have "success": true with a data object. Error responses have "success": false with an error object.

{
  "success": true,
  "data": { ... }
}

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "What went wrong",
    "details": [...]
  }
}

Setting Up Postman

If you prefer a GUI over curl, Postman is the industry standard. Here is how to set it up for TesterRank's Practice API.

1. Download Postman from postman.com/downloads and install it.
2. Go to Environments → Create New. Add two variables: baseUrl (set to your API base URL) and token (leave empty for now).
3. Create a POST request to {{baseUrl}}/auth/register. Set Body → raw → JSON with your name, email, and password.
4. In the register/login request, go to the Scripts → Post-response tab and add the auto-save script below.
5. For authenticated requests: go to the Authorization tab → Type: Bearer Token → Token: {{token}}.

if (pm.response.code === 200 || pm.response.code === 201) {
  var data = pm.response.json();
  pm.environment.set("token", data.data.token);
}

All API Endpoints