Vous n'êtes pas encore inscrit ? S'enregistrer | Mot de passe perdu ?

API lotro.fr

Présentation

L'API lotro.fr est un outil pour les développeurs web. Il permet de faire dialoguer n'importe quel site perso avec lotro.fr afin d'échanger des informations. Par exemple il est possible d'obtenir tous les détails d'une sortie, y compris les inscrits et les messages, ou de connaitre l'ensemble des membres d'une confrérie.

Le fonctionnement est assez simple. En interrogeant une url spéciale, vous obtenez en retour toutes les informations dont vous avez besoin au format XML. Il ne vous reste plus qu'à prendre dans le xml les infos qui vous intéressent. En php, vous pouvez utiliser par exemple simpleXML pour vous y aider. Alternativement, vous pouvez obtenir les informations au format JSON.

Les url de l'api sont construites comme cela :
http://lotro.fr/api/?uid=votre_api_number&a=le_code_action&p1=parametre&p2=parametre2...
votre_api_number : ce code est personnel à votre confrérie. Faites y très attention et ne le communiquez pas, il permet de réaliser la plupart des actions qu'un gérant de confrérie peut faire. Pour obtenir un API number, envoyez un MP a Enox
le_code_action : Code action dont la liste est donnée plus bas.
parametre : parametre qui dépend du code action. Certaines actions nécessitent des parametres, d'autres non.
Pour obtenir les informations au fomat JSON plutot que XML, ajoutez &out=json à la fin de l'url.

Voici la liste des codes actions utilisables :

  • memberlist
    Retourne la liste des membres
  • eventlist
    Retourne tous les événements à venir
  • eventdetail
    Retourne tous les détails d'un événement

memberlist

Retourne la liste des membres de la confrérie.
url : http://lotro.fr/api/?uid=votre_api_number&a=memberlist
Parametres : aucun
XML

<data>
	<message> objet décrivant le succès de la communication
		<type> succes ou error
		<text> le texte d'erreur ou un texte de réussite

	<persos> Liste de tous les personnages de la confrérie
		<perso> objet décrivant 1 personnage
			<id> Id du perso pour lotro.fr
			<pseudo> Nom du perso
			<server> Serveur
			<id_classe> Id de la classe pour lotro.fr
			<id_race> Id de la race pour lotro.fr
			<level> Niveau du personnage
			<reroll> Flag pour préciser qu'il s'agit d'un reroll
			<id_main> ID du perso main pour lotro.fr
			<pseudo_main> Nom du perso main
			<classname> Classe du perso
			<racename> Race du perso
			<id_guildrank> Id du rang dans la confrérie pour lotro.fr
			<id_vocation> ID de la vocation d'artisanat pour lotro.fr
			<vocation> Nom de la vocation
			<id_craftguilde> ID de la guilde d'artisanat pour lotro.fr
			<craftguilde> Guilde d'artisanat
			<idlvl_craftguilde> ID du niveau de réputation de la guilde d'artisanat pour lotro.fr
			<lvl_craftguilde> Niveau de réputation de la guilde d'artisanat
			<crafts> Liste des artisanats du personnage
				<craft> Détail d'un artisanat du personnage
					<id> ID d'artisanat pour lotro.fr
					<name> Nom d'artisanat
					<lvl> Niveau connu pour l'artisanat
					<maitrise> Niveau maitrisé pour l'artisanat
				<craft> ...
		<perso> ...

eventlist

Retourne tous les événements à venir.
url : http://lotro.fr/api/?uid=votre_api_number&a=eventlist&p=nb_jour_passés
Parametres :
nb_jour_passés : Nombre entre 0 et 14 (valeur par défaut 0). Permet d'afficher des événements passés jusqu'à 14 jours après leur date. Indiquer 0 pour ne voir que les sorties à venir.
XML

<data>
	<message> objet décrivant le succès de la communication
		<type> succes ou error
		<text> le texte d'erreur ou un texte de réussite

	<events> Liste des événements
		<event> objet décrivant un événement
			<id> Id de l'event pour lotro.fr
			<server> Serveur de l'événement
			<name> Nom de l'événement
			<visibility> Id de visibilité pour lotro.fr
			<visibilityname> Visibilité
			<id_guilde_orga> Id de la guilde organisatrice pour lotro.fr
			<guildename_orga> Nom de la guilde organisatrice
			<id_lead> Id de l'organisateur
			<leadname> Nom de l'organisateur
			<date> Date de l'événement
			<incertain_interdit> Flag pour interdire l'inscription "incertain"
			<event_annule> Flag pour annuler l'événement
			<invite_time> Heure pour les invitations 
			<pull_time> Heure de départ
			<finevent_time> Heure de fin
			<fininscription_time> Heure de fin d'inscriptions
			<event_closed> Flag inscriptions closes
			<place> Nombre de places
			<creation_date> Date de création
			<id_creator> Id du créateur pour lotro.fr
			<modif_date> Date de derniere modification
			<id_modif> Id du dernier modificateur
			<nb_groupe> Nombre de groupes
			<info> Détails
		<event>...

eventdetail

Retourne tous les détails d'un événement.
url : http://lotro.fr/api/?uid=votre_api_number&a=eventdetail&e=id_de_levent
Parametres :
id_de_levent : id de l'event pour lotro.fr
XML

<data>
	<message> objet décrivant le succès de la communication
		<type> succes ou error
		<text> le texte d'erreur ou un texte de réussite

	<event> objet décrivant l'événement
		<id> id de l'event pour lotro.fr
		<server> Serveur de l'evenement
		<name> Nom de l'événement
		<visibility> id de visibilité pour lotro.fr
		<visibilityname> Visibilité
		<id_guilde_orga> id de la guilde organisatrice pour lotro.fr
		<guildename_orga> Nom de la guilde organisatrice pour lotro.fr
		<id_lead> Id de l'organisateur pour lotro.fr
		<leadname> Nom de l'organisateur
		<date> Date de l'événement
		<incertain_interdit> Flag pour interdire l'inscription "incertain"
		<event_annule> Flag pour annuler l'événement
		<invite_time> Heure pour les invitations
		<pull_time> Heure de départ
		<finevent_time> Heure de fin
		<fininscription_time> Heure de cloture d'inscriptions
		<event_closed> Flag inscription closes
		<place> Nombre de places
		<creation_date> Date de création
		<id_creator> Id du créateur pour lotro.fr
		<modif_date> Date de dernière modification
		<id_modif> Id du dernier modificateur
		<nb_groupe> Nombre de groupes pour cet événement
		<info> Détails

		<inscrits> Liste des inscrits pour cet événement
			<inscrit> objet décrivant l'inscription d'un personnage et de ses rerolls autorisés
				<inscription_date> Date de l'inscription
				<modif_date> Date de derniere modification
				<id> Id du perso
				<pseudo> Nom du perso
				<level> Niveau du perso
				<id_classe> id de classe pour lotro.fr
				<classname> Classe du perso
				<status> id du statut d'inscription pour lotro.fr
				<statusname> Statut d'inscription
				<rolls> Liste des personnages alternatifs que le joueur inscrit accepte de jouer pour l'événement
					<roll> Personnage alternatif que le joueur inscrit accepte de jouer pour l'événement
						<id> id du perso pour lotro.fr
						<pseudo> Nom du perso
						<level> Niveau du perso
						<id_classe> id de classe pour lotro.fr
						<classname> Classe
					<roll>...
			<inscrit>...

		<event_msgs>  Liste des messages postés pour cette sortie
			<event_msg>  objet décrivant un message posté pour cette sortie
				<date> Date du message
				<id_perso> Id du perso posteur pour lotro.fr
				<pseudo> Nom du perso posteur
				<msg> Message
			<event_msg>...