Jamendo Api Documentation
GET /v3.0/albums/file
Description
Since February 2021, a new field called 'zip_allowed' is returned in these api:
It contains a boolean to know if you can propose or not the possibility to download the track through your application.
Indeed, now Jamendo artists can choose if they want to allow or not the download of their albums.
If you are already using this api (/v3.0/albums/file), please take time to modify your code to take into account this new 'zip_allowed' value.
Moreover, in April 2022, the api /v3.0/albums/file will start returning 404 error if 'zip_allowed' is false for the album you are trying to download.
The 'file' method represent an exception to the norm. Instead of returning a document object, here we http-redirect to the requested file url, in order to let your application download a certain resource. Note that here we don't inherit parent params declarations as usual, and that a not valid request will trigger an http error (404 or 500)
Required parameters
client_id && id
Parameter List
| Name | Type | Description |
|---|---|---|
| client_id | string | A Client Id provided by devportal.jamendo.com. |
| audioformat | enum: {mp3} | The audio format you wish to use on the fileurl returned field. At the moment mp32 (mp3 192kbps) is the only existing format. |
| id | integer | Applying a redirection this method accepts and needs only one album id |
Sample
Call:
https://api.jamendo.com/v3.0/albums/file/?client_id=your_client_id&id=1
Response:
(If the request is successfull you should be redirected to the requested file, but if the resource doesn't exists a 404 http error with an corresponding error message will be notified in the header. In case of malformed requests, you would receive an http code 500 with relative error information
