Welcome to the MSDN API Reference

This section provides detailed documentation for all available MSDN APIs. You'll find information on endpoints, parameters, request/response formats, and authentication methods.

Use the navigation pane on the left to browse different API categories or the search bar above to find specific endpoints.

Authentication API

Endpoints for managing user authentication and generating access tokens.

POST /auth/token

Obtains an access token for authenticated requests.

Request Body
{
  "grant_type": "password",
  "username": "user@example.com",
  "password": "your_password"
}
Parameters
Name Type Description Required
grant_type String Specifies the type of grant. Currently supports password. Yes
username String The user's email address. Yes
password String The user's password. Yes
Responses
Status Code Description Response Body
200 OK Token generated successfully. 
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}
401 Unauthorized Invalid credentials. 
{
  "error": "invalid_grant",
  "error_description": "Invalid username or password"
}

User Management API

Endpoints for retrieving and managing user profiles.

GET /users/{userId}

Retrieves a specific user's profile.

Path Parameters
Name Type Description Required
userId UUID The unique identifier of the user. Yes
Responses
Status Code Description Response Body
200 OK User profile retrieved. 
{
  "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "username": "john.doe@example.com",
  "firstName": "John",
  "lastName": "Doe",
  "createdAt": "2023-10-27T10:00:00Z"
}
404 Not Found User not found. 
{
  "error": "not_found",
  "message": "User with ID a1b2c3d4-e5f6-7890-1234-567890abcdef not found."
}

Product Catalog API

Endpoints for accessing product information.

GET /products

Retrieves a list of all available products.

Query Parameters
Name Type Description Required
category String Filter products by category. No
limit Integer Maximum number of products to return. No
offset Integer Number of products to skip for pagination. No
Responses
Status Code Description Response Body
200 OK List of products. 
[
  {
    "id": "prod_123",
    "name": "Wireless Mouse",
    "price": 25.99,
    "category": "Electronics",
    "inStock": true
  },
  {
    "id": "prod_456",
    "name": "Mechanical Keyboard",
    "price": 79.99,
    "category": "Electronics",
    "inStock": true
  }
]