L'API de HabboCity permet de récupérer des informations utiles telles que : l'avatar, l'humeur, les tweets, la story, les appartements, les groupes ou bien encore les statistiques d'un utilisateur.
I) API Utilisateur
II) API Avatar
I) API Utilisateur
https://api.habbocity.me/avatar_info.php?user=PSEUDO&key=CODE-SECRET
user: Le pseudonyme de l’utilisateur
key: Le code secret fourni par les responsables des organisations.
https://api.habbocity.me/avatar_info.php?uniqueId=IDENTIFIANT-UNIQUE&key=CODE-SECRET
uniqueId: L’identifiant unique de l’utilisateur
key: Le code secret fourni par les responsables des organisations.
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 !"} |
Une requête renvoi toujours les données suivantes:
duckets: Quantité de duckets
diamonds: Quantité de diamants
uniqueId: Identifiant unique
name: Pseudonyme
avatar: Code de look
online: Si l’utilisateur est en ligne ou non
register: Date d’inscription
gender: Sexe de l’utilisateur
Obtenir une key (CODE-SECRET)
Vous devez effectuer une demande auprès du support ou directement aux responsables des organisations. Attention, il est obligatoire d'être organisation officiellepour pouvoir obtenir une key. En cas d'exception, vous pouvez toujours venir nous parler de votre projet via le support du site . Il vous sera, peut-être, possible de récupérer exceptionnellement une key le temps du développement de votre projet par exemple.
Code d’exemple
<?php function cURL($url) { $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); $response = curl_exec($ch); curl_close($ch); return $response; } $key = “CODE-SECRET”; $user = "Kaana"; $json = cURL('https://api.habbocity.me/avatar_info.php?user='.$user.'&key=’.$key); $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 ! ?> |
https://api.habbocity.me/avatar_info.php?user=PSEUDO&key=CODE-SECRET&groups&rooms
Cette URL permet d’afficher en plus des informations de base, les groupes ainsi que les appartements de l’utilisateur, car nous avons indiqué dans l’url de la demande les groupes avec &groups et les appartements avec &rooms
Liste des données disponibles
selectedBanner: Retourne la bannière actuellement portée.
banner_id: L'identifiant de la bannière
selectedBadges: Retourne les badges actuellement portés.
badgeIndex: Position du badge
code: Le code du badge
name: Le nom du badge
description: La description du badge
groups: Retourne les groupes dont l’utilisateur est adhéré.
uniqueId: L’identifiant unique du groupe
name: Nom du groupe
description: Description du groupe
badge: URL de l’image du groupe
ownerId: Identifiant de l’auteur
roomId: Identifiant de l’appartement
accessLevel: Type de groupe (ouvert, fermé, sur validation)
relationship: Retourne les relations de l’utilisateur.
uniqueId: Identifiant unique de la relation
name: Pseudonyme de l’utilisateur avec qui la relation est établie
level: Type de relation (heart : Coeur, smile : Sourire jaune, bobba : Tête de mort)
rooms: Retourne la liste des appartements de l’utilisateur ainsi que les informations détaillées de l’appartement.
uniqueId: Identifiant unique de l’appartement
name: Nom de l’appartement
description: Description
tags: Tags de l’appartement
category: Catégorie (Jeux, Rencontres, etc.)
likes: Mentions j’aime de l’appartement
accessType: Type d’accès (ouvert, mot de passe, sonnette)
maxUsers: Nombre maximal que l’appartement peut contenir
speedRoller: Vitesse des rollers
thumbnail: Image de l’appartement
tradeState: L’échange est activé ou non dans l’appartement
valueDiamonds: La valeur de l'appartement en diamants
statistics: Retourne les statistiques de l’utilisateur.
playingTime: Durée de jeu totale
respect: Nombre de respects reçus
winwins: Nombre de winwins
chatCount: Nombre de messages totaux
buildCount: Nombre de constructions, d’objets déplacés, déposés et retirés totaux
visitedRooms: Nombre d’appartements visités
privateChatCount: Nombre de messages privés totaux
movementsCount: Nombre de déplacements effectués
lastTweets: Retourne les 50 derniers tweets de l’utilisateur.
text: Contenu du tweet
retweets: Nombre de retweets
likes: Nombre de likes
createdAt: Date de création du Tweet
story: Retourne la story de l’utilisateur.
photo: URL de l’image
createdAt: Date de création de la story
text: Écriture sur la photo
positionTop: Position de l’écriture sur la photo
lastForumPosts: Retourne les dernières publications de l’utilisateur sur le forum.
postText: Le contenu du message
postDate: Date de publication du message
postAuthorId: Identifiant de l’utilisateur
postAuthorUsername: Pseudonyme de l’utilisateur
postAuthorFigure: Code d’avatar de l’utilisateur
threadAuthorId: Identifiant de l’auteur du topic
threadAuthorUsername: Pseudonyme de l’auteur du topic
threadAuthorFigure: Code de look de l’auteur du topic
threadTitle: Titre du topic
threadDate: Date de publication du topic
threadLastActivity: Dernière activité du topic
threadClose: Statut du topic (fermé / ouvert)
wealth: Retourne l’historique sur 93 jours de la richesse de l’utilisateur.
diamonds: Quantité de diamants
duckets: Quantité de duckets
netWorth: Richesse totale
classics: Nombre de classiques
date: Jour des données
II) API D’AVATAR
https://api.habbocity.me/avatar_image.php?user=PSEUDO&headonly=0&direction=3&head_direction=3&size=l
user: Le pseudonyme de l’utilisateur
action: Action effectué par l’utilisateur (std,sit,lay,wlk,wav,sit-wav,swm)
direction: La direction de l’avatar (0 à 7)
head_direction: La direction de la tête de l’avatar (0 à 7)
gesture: (actions du visage: (std,agr,sml,sad,srp,spk,eyb))
size: Taille de l’avatar (l,s,n,big)
headonly: Afficher la tête sans le corps (0 ou 1)