API

Informations

Accès

http://api.altermusique.org/format/cible/

Formats

json
Sortie JSON classique
jsonp
Même chose que json mais le JSON se retrouve appelé en argument d'une fonction à définir dans le paramètre callback en query string.
xml
XML formatté et valide
rawxml
XML simple sans en-tête

Cibles

all
renvoie l'intégralité du catalogue du site, par album, chaque album ayant dans son arborescence les pistes de l'album.
last
renvoie les [max] derniers albums parus. Où [max] est un nombre spécifié dans le paramètre max en query string, ou sinon 25.
popular
renvoie les [max] albums les plus écoutés ou téléchargés sur le mois précédent. Où [max] est un nombre spécifié dans le paramètre max en query string, ou sinon 25.
search
renvoie les albums dont le titre ou le nom de l'artiste contient [query]. Où [query] est un nombre spécifié dans le paramètre query en query string.

Champs

id
Numéro unique de l'album
name
Nom de l'album
release
Année de sortie de l'album
genre
Genre de l'album (en toutes lettres, champ libre rempli par l'artiste)
desc
Description de l'album (peut contenir du HTML)
url
Adresse publique de la page de l'album
license_url
Adresse unique de la licence de l'album
artist_id
Numéro unique de l'artiste
artist_url
Adresse unique de la page publique de l'artiste
artist_name
Nom de l'artiste
cover_url
Adresse de l'image de la pochette de l'album en 600x600
thumb_url
Adresse de l'image de la pochette de l'album en 96x96
download_ogg
Adresse de téléchargement de l'album en Ogg Vorbis (qualité moyenne, V8)
download_mp3
Adresse de téléchargement de l'album en MP3 (basse qualité, VBR 192 kbps)
embed_url
Adresse du lecteur à installer dans une page web
tracks
Liste des morceaux de l'album
nb
Numéro d'ordre du morceau
title
Titre du morceau
time
Temps en secondes du morceau
listen_url
Adresse d'écoute/téléchargement du morceau en basse qualité (MP3 24kbps mono)
download_url
Adresse d'écoute/téléchargement du morceau en qualité moyenne (MP3 128kbps stéréo)

Exemple