Sign in
Players

List product players

This endpoint allows you to retrieve all the players in a product.

get/1/radios/{radio_product_id}/players

Path parameters

radio_product_idinteger required

The unique identifier (ID) of the radio product to request.

Query parameters

withstring

Optional : Allows loading additional data about a resource, which may include related resources.

typestring[]

Type of the resource {name}

[
  "4"
]
return'total'

Optional : If you pass this parameter with the value total, then the response will be the number of items in the collection, instead of the items themselves.<br /> Part of the total capacity

limitinteger

Optional parameter that define the number of items to return<br /> Part of the offset capacity

skipinteger

Optional parameter that define the index of the first item to return (0 = first item)<br /> Part of the offset capacity

pageinteger

Optional parameter that define the page number<br /> Part of the pagination capacity

per_pageinteger

Optional parameter that define the number of items per page<br /> Part of the pagination capacity

string
OR
string[]

Optional parameter that define the field used for sorting<br /> Part of the sort capacity

order'asc' | 'desc'

Optional parameter that define the default sort order<br /> Part of the sort capacity

order_forobject

Optional parameter that define the sorting order for a field<br /> By default order is used<br /> Part of the sort capacity

Response

OK

result'success' | 'error' | 'asynchronous' required

Result of the HTTP request

totalinteger

Total number of items Added when using query parameter page

pageinteger

Number of the current page Added when using query parameter page

pagesinteger

Total number of pages Added when using query parameter page

items_per_pageinteger

Number of items per page Added when using query parameter page

Example response

{
  "result": "success",
  "data": [
    {
      "display_name": "MyRadioPlayer",
      "volume": 50,
      "language": "fr",
      "height": 144,
      "width": 505,
      "button_color": "FFFFFF",
      "background_color": "202020",
      "secondary_color": "0098FF",
      "thumbnail": "https://storage.infomaniak.com/player/my-thumbnail.png",
      "listeners_hold": 100,
      "twitter_account": "MyAccount",
      "twitter_backlink": "my-radio.ch",
      "twitter_hashtag": "infomaniak,radio",
      "loading": "https://storage.infomaniak.com/player/my-loading.png",
      "unavailable": "https://storage.infomaniak.com/player/my-unavailable.png",
      "restriction": "https://storage.infomaniak.com/player/my-restriction.png",
      "history_display": "split",
      "history_hold": 20,
      "id": 1,
      "uuid": "b3ff3bf9-c390-4dfe-9341-5e3a5e408bc2",
      "name": "Mayuri",
      "type": 4,
      "iframe": "<iframe src=\"my-player.infomaniak.com\" width=\"505.00px\" height=\"144.00px\" style=\"border-width:0\"></iframe>",
      "domains": "infomaniak.com,my-radio.ch",
      "created_at": 1473718107,
      "updated_at": 1699291082
    }
  ],
  "total": 221,
  "page": 2,
  "pages": 15,
  "items_per_page": 15
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.