GET api/Song?title={title}&artistName={artistName}&albumName={albumName}&page={page}

Get a paged list of songs matching the given search criteria

Request Information

URI Parameters

NameDescriptionTypeAdditional information
title

(Part of) the title of the song to search for

string

Required

artistName

(Part of) the name of the artist of the song to search for

string

Required

albumName

(Part of) the name of the album of the song to search for

string

Required

page

The page number, starts at 1

integer

Required

Body Parameters

None.

Response Information

Resource Description

SongListReponseModel
NameDescriptionTypeAdditional information
TotalSongCount

Total amount of songs in the database

integer

None.

PageSize

Page size which is defined on the side of the server

integer

None.

Songs

List of songs

Collection of SongModel

None.

Response Formats

application/json, text/json

Sample:
{
  "TotalSongCount": 1,
  "PageSize": 2,
  "Songs": [
    {
      "Id": "543ce1ac-76cb-4bad-ae3d-3e3b3b5c74a7",
      "ArtistName": "sample string 2",
      "AlbumName": "sample string 3",
      "Title": "sample string 4",
      "Duration": 5,
      "PreviewAvailable": true,
      "Extension": "sample string 7"
    },
    {
      "Id": "543ce1ac-76cb-4bad-ae3d-3e3b3b5c74a7",
      "ArtistName": "sample string 2",
      "AlbumName": "sample string 3",
      "Title": "sample string 4",
      "Duration": 5,
      "PreviewAvailable": true,
      "Extension": "sample string 7"
    }
  ]
}

application/xml, text/xml

Sample:
<SongListReponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Mk2.AkoestIq.Web.Services.Song.Models">
  <PageSize>2</PageSize>
  <Songs>
    <SongModel>
      <AlbumName>sample string 3</AlbumName>
      <ArtistName>sample string 2</ArtistName>
      <Duration>5</Duration>
      <Extension>sample string 7</Extension>
      <Id>543ce1ac-76cb-4bad-ae3d-3e3b3b5c74a7</Id>
      <PreviewAvailable>true</PreviewAvailable>
      <Title>sample string 4</Title>
    </SongModel>
    <SongModel>
      <AlbumName>sample string 3</AlbumName>
      <ArtistName>sample string 2</ArtistName>
      <Duration>5</Duration>
      <Extension>sample string 7</Extension>
      <Id>543ce1ac-76cb-4bad-ae3d-3e3b3b5c74a7</Id>
      <PreviewAvailable>true</PreviewAvailable>
      <Title>sample string 4</Title>
    </SongModel>
  </Songs>
  <TotalSongCount>1</TotalSongCount>
</SongListReponseModel>