Users API

GET /api/users

{
  "users": [
    {
      "id": 1,
      "username": "admin",
      "email": "[email protected]",
      "created_at": "2023-01-01T00:00:00Z",
      "status": "active"
    },
    {
      "id": 2,
      "username": "user1",
      "email": "[email protected]",
      "created_at": "2023-01-02T00:00:00Z",
      "status": "active"
    }
  ]
}

GET /api/users/{id}

{
  "user": {
    "id": 1,
    "username": "admin",
    "email": "[email protected]",
    "created_at": "2023-01-01T00:00:00Z",
    "updated_at": "2023-01-10T00:00:00Z",
    "status": "active",
    "roles": [
      {
        "id": 1,
        "name": "admin",
        "description": "Administrator"
      }
    ]
  }
}

POST /api/users

{
  "username": "newuser",
  "email": "[email protected]",
  "password": "securepassword",
  "role_ids": [2]
}

{
  "message": "User created successfully",
  "user": {
    "id": 3,
    "username": "newuser",
    "email": "[email protected]",
    "created_at": "2023-03-15T12:00:00Z",
    "status": "active"
  }
}

PUT /api/users/{id}

{
  "username": "updateduser",
  "email": "[email protected]",
  "password": "newsecurepassword",
  "status": "active"
}

{
  "message": "User updated successfully",
  "user": {
    "id": 3,
    "username": "updateduser",
    "email": "[email protected]",
    "created_at": "2023-03-15T12:00:00Z",
    "updated_at": "2023-03-16T14:30:00Z",
    "status": "active"
  }
}

POST /api/users/{id}/block

{
  "reason": "Site rules violation",
  "until": "2023-04-15T00:00:00Z"
}

{
  "message": "User blocked successfully"
}

POST /api/users/{id}/unblock

{
  "message": "User unblocked successfully"
}

PUT /api/users/{id}/roles

{
  "role_ids": [1, 2, 3]
}

{
  "message": "User roles updated successfully",
  "user": {
    "id": 3,
    "username": "user3",
    "email": "[email protected]",
    "roles": [
      {
        "id": 1,
        "name": "admin",
        "description": "Administrator"
      },
      {
        "id": 2,
        "name": "moderator",
        "description": "Moderator"
      },
      {
        "id": 3,
        "name": "user",
        "description": "User"
      }
    ]
  }
}

GET /api/users/{id}/social-networks

{
  "social_networks": [
    {
      "id": 1,
      "network": "vk",
      "profile_url": "https://vk.com/username"
    },
    {
      "id": 2,
      "network": "telegram",
      "profile_url": "@username"
    }
  ]
}

POST /api/users/{id}/social-networks

{
  "network_id": 1,
  "profile_url": "https://vk.com/new_username"
}

{
  "message": "Social network added successfully",
  "social_network": {
    "id": 3,
    "network": "vk",
    "profile_url": "https://vk.com/new_username"
  }
}

DELETE /api/users/{userId}/social-networks/{networkId}

{
  "message": "Social network removed successfully"
}

GET /api/users/{id}/devices

{
  "devices": [
    {
      "id": 1,
      "name": "Chrome on Windows",
      "last_active": "2023-03-15T12:00:00Z",
      "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/111.0.0.0 Safari/537.36"
    },
    {
      "id": 2,
      "name": "Firefox on MacOS",
      "last_active": "2023-03-10T14:30:00Z",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:109.0) Gecko/20100101 Firefox/111.0"
    }
  ]
}

DELETE /api/users/{userId}/devices/{deviceId}

{
  "message": "Device removed successfully"
}

GET /api/users/search

{
  "users": [
    {
      "id": 1,
      "username": "admin",
      "email": "[email protected]",
      "created_at": "2023-01-01T00:00:00Z",
      "status": "active"
    },
    {
      "id": 5,
      "username": "administrator",
      "email": "[email protected]",
      "created_at": "2023-01-05T00:00:00Z",
      "status": "active"
    }
  ]
}