Voici une documentation sur les méthodes de l’API.

Tout d’abord voici les spécifications (JSON RPC 2.0) : http://www.jsonrpc.org/specification

L’accès à l’API se fait par l’url : URL_JEEDOM/core/api/jeeApi.php

Voici un example de configuration d’un objet Json utilisable dans le corps d’une requête faite par un agent HTTP:

{
    "jsonrpc": "2.0",
    "id": "007",
    "method": "event::changes",
    "params": {
        "apikey": "",
        "datetime": "0"
    }
}

Divers

ping

Retourne pong, permet de tester la communication avec Jeedom

version

Retourne la version de Jeedom

datetime

Retourne le datetime de Jeedom en microsecondes

API config

config::byKey

Retourne une valeur de configuration.

Paramètres Json :

• string key : clef de la valeur de configuration à retourner

• string plugin : (optionnel), plugin de la valeur de configuration

• string default : (optionnel), valeur à retourner si la clef n’existe pas

config::save

Enregistre une valeur de configuration

Paramètres Json :

• string value : valeur à enregistrer

• string key : clef de la valeur de configuration à enregistrer

• string plugin : (optionnel), plugin de la valeur de configuration à enregistrer

API JSON Event

event::changes

Retourne la liste des changements depuis le datetime passé en paramètre (doit être en microsecondes). Vous aurez aussi dans la réponse le datetime courant de Jeedom (à réutiliser pour l’interrogation suivante)

Paramètres Json :

• int datetime

API JSON Plugin

plugin::listPlugin

Retourne la liste de tous les plugins

Paramètres Json :

• int activateOnly = 0 (ne retourne que la liste des plugins activés)

• int orderByCaterogy = 0 (retourne la liste des plugins triés par catégorie)

API JSON Objet

jeeObject::all

Retourne la liste de tous les objets

jeeObject::full

Retourne la liste de tous les objets, avec pour chaque objet tous ses équipements et pour chaque équipement toutes ses commandes ainsi que les états de celles-ci (pour les commandes de type info)

jeeObject::fullById

Retourne un objet avec tous ses équipements et pour chaque équipement toutes ses commandes ainsi que les états de celles-ci (pour les commandes de type info)

Paramètres Json :

• int id

jeeObject::byId

Retourne l’objet spécifié

Paramètres:

• int id

jeeObject::fullById

Retourne un objet, ses équipements et pour chaque équipement toutes ses commandes ainsi que les états de cellse-ci (pour les commandes de type info)

jeeObject::save

Retourne l’objet spécifié

Paramètres:

• int id (vide si c’est une création)

• string name

• int father_id = null

• int isVisible = 0

• int position

• array configuration

• array display

API JSON Summary

summary::global

Retourne le résumé global pour la clef passée en paramètre

Paramètres:

• string key : (optionnel), clef du résumé voulu, si vide alors Jeedom vous renvoie le résumé pour toutes les clefs

summary::byId

Retourne le résumé pour l’objet id

Paramètres:

• int id : id de l’objet

• string key : (optionnel), clef du résumé voulu, si vide alors Jeedom vous renvoie le résumé pour toutes les clefs

API JSON EqLogic

eqLogic::all

Retourne la liste de tous les équipements

eqLogic::fullById

Retourne un équipement et ses commandes ainsi que les états de celles-ci (pour les commandes de type info)

Paramètres:

• int id

eqLogic::byId

Retourne l’équipement spécifié

Paramètres:

• int id

eqLogic::byType

Retourne tous les équipements appartenant au type (plugin) spécifié

Paramètres:

• string type

eqLogic::byObjectId

Retourne tous les équipements appartenant à l’objet spécifié

Paramètres:

• int object_id

eqLogic::byTypeAndId

Renvoi un tableau d’équipement en fonction des paramètres.

Le retour sera de la forme array(‘eqType1’ ⇒array( ‘id’⇒…​,’cmds’ ⇒ array(…​.)),’eqType2’ ⇒array( ‘id’⇒…​,’cmds’ ⇒ array(…​.))…​.,id1 ⇒ array( ‘id’⇒…​,’cmds’ ⇒ array(…​.)),id2 ⇒ array( ‘id’⇒…​,’cmds’ ⇒ array(…​.))..)

Paramètres:

• string[] eqType = tableau des types d’équipements voulus

• int[] id = tableau des ID d’équipements personnalisés voulus

eqLogic::save

Retourne l’équipement enregistré/créé

Paramètres:

• int id (vide si c’est une création)

• string eqType_name (type de l’équipement script, virtuel…​)

• string name

• string logicalId = ‘’

• int object_id = null

• int eqReal_id = null

• int isVisible = 0

• int isEnable = 0

• array configuration

• int timeout

• array category

API JSON Cmd

cmd::all

Retourne la liste de toutes les commandes

cmd::byId

Retourne la commande spécifiée

Paramètres:

• int id

cmd::byEqLogicId

Retourne toutes les commandes appartenant à l’équipement spécifié

Paramètres:

• int eqLogic_id

cmd::execCmd

Exécute la commande spécifiée

Paramètres:

• int id : id d’une commande ou tableau d’id si vous voulez executer plusieurs commandes d’un coup

• [options] Liste des options de la commande (dépend du type et du sous-type de la commande)

cmd::getStatistique

Retourne les statistiques sur la commande (ne marche que sur les commandes de type info et historisées)

Paramètres:

• int id

• string startTime : date de début de calcul des statistiques

• string endTime : date de fin de calcul des statistiques

cmd::getTendance

Retourne la tendance sur la commande (ne marche que sur les commandes de type info et historisées)

Paramètres:

• int id

• string startTime : date de début de calcul de la tendance

• string endTime : date de fin de calcul de la tendance

cmd::getHistory

Retourne l’historique de la commande (ne marche que sur les commandes de type info et historisées)

Paramètres:

• int id

• string startTime : date de début de l’historique

• string endTime : date de fin de l’historique

cmd::save

Retourne l’objet spécifié

Paramètres:

• int id (vide si c’est une création)

• string name

• string logicalId

• string eqType

• string order

• string type

• string subType

• int eqLogic_id

• int isHistorized = 0

• string unite = ‘’

• array configuration

• array template

• array display

• array html

• int value = null

• int isVisible = 1

• array alert

cmd::event

Permet d’envoyer une valeur à une commande

Paramètres:

• int id

• string value : valeur

• string datetime : (optionnel) datetime de la valeur

API JSON Scenario

scenario::all

Retourne la liste de tous les scénarios

scenario::byId

Retourne le scénario spécifié

Paramètres:

• int id

scenario::export

Retourne l’export du scénario ainsi que le nom humain du scénario

Paramètres:

• int id

scenario::import

Permet d’importer un scénario.

Paramètres:

• int id : id du scénario dans lequel importer (vide si création)

• string humanName : nom humain du scénario (vide si création)

• array import : scénario (issue du champ export de scenario::export)

scenario::changeState

Change l’état du scénario spécifié.

Paramètres:

• int id

• string state : [run,stop,enable,disable]

API JSON Log

log::get

Permet de récupérer un log

Paramètres:

• string log : nom du log à récupérer

• string start : numéro de ligne sur laquelle commencer la lecture

• string nbLine : nombre de lignes à récupérer

log::add

Permet d’écrire dans un log

Paramètres:

• string log : nom du log à récupérer

• string type : type de log (debug, info, warning, error)

• string message : message texte à écrire

• string logicalId : logicalId du message généré

log::list

Permet de récupérer la list des logs de Jeedom

Paramètres:

• string filtre : (optionnel) filtre sur le nom des logs à récupérer

log::empty

Permet de vider un log

Paramètres:

• string log : nom du log à vider

log::remove

Permet de supprimer un log

Paramètres:

• string log : nom du log a supprimer

API JSON datastore (variable)

datastore::byTypeLinkIdKey

Récupère la valeur d’une variable stockée dans le datastore

Paramètres:

• string type : type de la valeur stockée (pour les scénarios c’est scenario)

• id linkId : -1 pour le global (valeur pour les scénarios par défaut, ou l’id du scénario)

• string key : nom de la valeur

datastore::save

Enregistre la valeur d’une variable dans le datastore

Paramètres:

• string type : type de la valeur stockée (pour les scénarios c’est scenario)

• id linkId : -1 pour le global (valeur pour les scénarios par défaut, ou l’id du scénario)

• string key : nom de la valeur

• mixte value : valeur à enregistrer

API JSON Message

message::all

Retourne la liste de tous les messages

message::add

Permet d’écrire dans un log

Paramètres:

• string type : type de log (debug, info, warning, error)

• string message : message

• string action : action

• string logicalId : logicalId

message::removeAll

Supprime tous les messages

API JSON Interaction

interact::tryToReply

Essaie de faire correspondre une demande avec une interaction, exécute l’action et répond en conséquence

Paramètres:

• query (phrase de la demande)

• int reply_cmd = NULL : ID de la commande à utiliser pour répondre, si non préciser alors Jeedom vous renvoie la réponse dans le json

interactQuery::all

Renvoi la liste complete de toute les interactions

API JSON System

jeedom::halt

Permet d’arrêter Jeedom

jeedom::reboot

Permet de redémarrer Jeedom

jeedom::isOk

Permet de savoir si l’état global de Jeedom est OK

jeedom::update

Permet de lancer un update de Jeedom

jeedom::backup

Permet de lancer un backup de Jeedom

jeedom::getUsbMapping

Liste des ports USB et des noms de clefs USB branchés dessus

API JSON plugin

plugin::install

Installation/Mise à jour d’un plugin donné

Paramètres:

• int plugin_id (optionnel) : id du plugin
• string logicalId (optionnel) : nom du plugin (nom logique)

plugin::remove

Suppression d’un plugin donné

Paramètres:

• int plugin_id (optionnel) : id du plugin
• string logicalId (optionnel) : nom du plugin (nom logique)

plugin::dependancyInfo

Renvoi les informations sur le status des dépendances du plugin

Paramètres:

• int plugin_id (optionnel) : id du plugin
• string logicalId (optionnel) : nom du plugin (nom logique)

plugin::dependancyInstall

Force l’installation des dépendances du plugin

Paramètres:

• int plugin_id (optionnel) : id du plugin
• string logicalId (optionnel) : nom du plugin (nom logique)

plugin::deamonInfo

Renvoi les informations sur le status du démon du plugin

Paramètres:

• int plugin_id (optionnel) : id du plugin
• string logicalId (optionnel) : nom du plugin (nom logique)

plugin::deamonStart

Force le démarrage du démon

Paramètres:

• int plugin_id (optionnel) : id du plugin
• string logicalId (optionnel) : nom du plugin (nom logique)

plugin::deamonStop

Force l’arret du démon

Paramètres:

• int plugin_id (optionnel) : id du plugin
• string logicalId (optionnel) : nom du plugin (nom logique)

plugin::deamonChangeAutoMode

Change le mode de gestion du démon

Paramètres:

• int plugin_id (optionnel) : id du plugin
• string logicalId (optionnel) : nom du plugin (nom logique)
• int mode : 1 pour automatique, 0 pour manuel

API JSON update

update::all

Retourne la liste de tous les composants installés, leurs versions et les informations associées

update::checkUpdate

Permet de vérifier les mises à jour

update::update

Permet de mettre à jour Jeedom et tous les plugins

update::doUpdate

Paramètres:

• int plugin_id (optionnel) : id du plugin
• string logicalId (optionnel) : nom du plugin (nom logique)

API JSON network

network::restartDns

Force le (re)démarrage du DNS Jeedom

network::stopDns

Force l’arret du DNS Jeedom

network::dnsRun

API JSON timeline

timeline::all

Retourne tous les éléments de la timeline

timeline::listFolder

Retourne tous les dossier (catégorie) de la timeline

timeline::byFolder

Retourne tous les éléments du dossier demandé

Paramètres:

• string folder : nom du dossier

API JSON User

user::all

Retourne la liste de tous les utilisateurs

user::save

Crée ou edite un utilisateur

Paramètres:

• int id (si edition)

• string login 

• string password 

• string profile : [admin,user,restrict]

API JSON Exemples

Voici un exemple d’utilisation de l’API. Pour l’exemple ci-dessous j’utilise cette classe php qui permet de simplifier l’utilisation de l’api.

Récupération de la liste des objets :

$jsonrpc = new jsonrpcClient('#URL_JEEDOM#/core/api/jeeApi.php', #API_KEY#);
if($jsonrpc->sendRequest('jeeObject::all', array())){
    print_r($jsonrpc->getResult());
}else{
    echo $jsonrpc->getError();
}

Exécution d’une commande (avec comme option un titre et un message)

$jsonrpc = new jsonrpcClient('#URL_JEEDOM#/core/api/jeeApi.php', #API_KEY#);
if($jsonrpc->sendRequest('cmd::execCmd', array('id' => #cmd_id#, 'options' => array('title' => 'Coucou', 'message' => 'Ca marche')))){
    echo 'OK';
}else{
    echo $jsonrpc->getError();
}

L’API est bien sûr utilisable avec d’autres langages (simplement un post sur une page)