# Музыкальный Сервис

## HTTP API

### Create New Track

---

Создаёт новый трек.

```http
PUT /api/tracks
Accept: application/json
```

#### Пример тела запроса 

```json
{
  "title": "My Track Title",
  "author": "Me",
  "duration": 123000
}
```

#### Пример ответа

```json
{
  "id": 1,
  "title": "My Track Title",
  "author": "Me",
  "duration": 123000,
  "auditions": 0
}
```

### Get Track

---

Возвращает трек по идентификатору.

```http
GET /api/tracks/{id}
```

#### Пример ответа

```json
{
  "id": 1,
  "title": "My Track Title",
  "author": "Me",
  "duration": 123000,
  "auditions": 0
}
```

### Increment auditions

---

Увеличивает число прослушиваний трека на 1.

```http
POST /api/tracks/auditions/{id}
```

#### Пример ответа

```json
{
  "auditions": 1
}
```

### Top Tracks

---

Возвращает список из десяти наиболее прослушиваемых треков.

```http
GET /api/tracks/top
```

#### Пример ответа

```json
[
  {
    "id": 1,
    "title": "My Track Title",
    "author": "Me",
    "duration": 123000,
    "auditions": 0
  },
  {
    "id": 2,
    "title": "My Track Title",
    "author": "Me",
    "duration": 123000,
    "auditions": 0
  },
  ...
]
```