my-blog-posts/music-track-service/index.md

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

HTTP API

Create New Track

---

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

PUT /api/tracks HTTP/1.1
Accept: application/json

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

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

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

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

Get Track

---

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

GET /api/tracks/{id} HTTP/1.1

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

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

Increment auditions

---

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

POST /api/tracks/auditions/{id} HTTP/1.1

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

{
  "auditions": 1
}

Top Tracks

---

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

GET /api/tracks/top HTTP/1.1

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

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