Bonjour à tous,

Je vais vous présenter comment utiliser l'API HabboCity qui permet depuis une application externe (site web, logiciel etc.) de récupérer des informations utiles telles que le pseudonyme, le look, la mission, les badges, les groupes,  l'id d'un utilisateur d'HabboCity etc...

I) API disponible uniquement pour les fans sites et RPG officiels:

https://api.habbocity.me/avatar_info.php?user=PSEUDO&key=CODE-SECRET


Cette appellation nous renvoie le code suivant:

{"id":4,"username":"Kaana","avatar":"ch-210-110.wa-2011-153638.sh-3035-92.ha-987462863-153638.lg-3078-1423.hr-831-1342.hd-3091-4.ca-3217-153638-153640","motto":"The show must go on !"}

Il vous faut maintenant un CODE-SECRET à demander auprès du support ou directement au gestionnaire des fans sites. Attention il est obligatoire d'être fan site officiel pour pouvoir obtenir un CODE-SECRET. En cas d'exception vous pouvez toujours venir nous parler de votre projet via le support du site il peut-être possible de récupérer exceptionnellement un CODE-SECRET le temps de construction de votre projet par exemple.

Je vous partage également un petit code PHP qui peut vous servir d'exemple pour l'utilisation d'API.

<?php 
function cURL($url) {
     $ch = curl_init($url);
     curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
     $response = curl_exec($ch);
     curl_close($ch);
     return $response;
}

$pseudonyme = "Kaana";
$json = cURL('https://api.habbocity.me/avatar_info.php?user='.$pseudonyme.'&key=xxxx');
$data = json_decode($json);

echo $data->avatar; // Affiche ha-1026-153638.sh-54429-1313-153640.hr-3163-31.ch-3323-92-153640.lg-3057-92.hd-209-1389
echo $data->motto; // Affiche The show must go on !
?>

Il existe également deux options badge et groupe qui permettent de connaitre les codes des badges que l'utilisateur porte sur lui ainsi que les groupes auquel il a adhéré. Pour activer une option il suffit d'ajouter &badge ou/et &groupe dans l'adresse URL de l'API ce qui nous donnera:

https://api.habbocity.me/avatar_info.php?user=PSEUDO&key=CODE-SECRET&badge //Pour activer l'option badge
https://api.habbocity.me/avatar_info.php?user=PSEUDO&key=CODE-SECRET&groupe //Pour activer l'option groupe
https://api.habbocity.me/avatar_info.php?user=PSEUDO&key=CODE-SECRET&relations //Afficher ses relations
https://api.habbocity.me/avatar_info.php?user=PSEUDO&key=CODE-SECRET&appartements //Afficher ses appartements


II) API pour récupérer l'avatar image d'un utilisateur d'HabboCity (disponible pour tous sans code secret) [NOUVEAU]:

N'hésitez pas à personnaliser les paramètres. 

https://api.habbocity.me/avatar_image.php?user=PSEUDO&headonly=0&direction=3&head_direction=3&size=l



Il existe également une Class permettant d'utiliser notre API de façon simplifier. Le code est en Open Source sur les pages suivantes:

III) Class Open Source en PHP pour vous aider:

Class ApiHabboCity avec toutes les fonctions préconstruites pour vous aider à manipuler l'API:

https://api.habbocity.me/ApiHabboCity.php.txt


et le fichier d'exemple d'utilisation:


https://api.habbocity.me/test.php.txt