MOBOTIX Online-Hilfe

API HTTP

L'HTTP-API (Application Programming Interface) est une interface logicielle vers la caméra et permet d'intégrer de façon conviviale la caméra à un système de gestion centralisée. L'interface est composée de deux scripts CGI que vous pouvez appeler via les commandes HTTP avec les paramètres et les valeurs. Ces scripts vous permettent de modifier les configurations et les sous-menus de Configuration ou les fonctions.

La commande HTTP http://192.168.100.10/control/control vous permet de modifier les paramètres du menu Configuration.

Exécution des fonctions de la caméra

La commande HTTP http://192.168.100.10/control/rcontrol vous permet d'exécuter certaines fonctions de la caméra.

Syntaxe des appels de commande

Commande contenant une instruction

Par exemple, si vous souhaitez utiliser l'instruction list avec la commande control, l'instruction suivante doit être séparée de la commande par un ? :
   http://192.168.100.10/control/control?list

Commande contenant une instruction et une combinaison paramètre/valeur

Pour être exécutable, une instruction doit être séparée du paramètre par un &. La valeur du paramètre peut être identifiable grâce au signe = :
   http://192.168.100.10/control/control?list&section=actions

Commande contenant une instruction et plusieurs combinaisons paramètre/valeur

Si vous souhaitez attribuer plusieurs paramètres, vous devez les séparer par un & :
    http://192.168.100.10/control/rcontrol?action=ledson&time=5

Plusieurs valeurs pour un paramètre

Certains paramètres exigent deux valeurs pour appliquer la modification aux objectifs. On peut reconnaître ces paramètres à leurs deux valeurs standard (par exemple, 0 0). Dans les commandes HTTP, les valeurs sont séparées par un + :
   http://192.168.100.10/control/control?set&section=general&sharpen=0+0

Fins de ligne des appels de commande

Si l'appel de commande contient une ou plusieurs fins de ligne (par exemple, afin de définir les définitions de la fenêtre de détection de mouvements), celles-ci doivent être représentées par le caractère générique CGI %0A.    http://192.168.100.10/control/control?set&section=general&
    coverimage_area=0,540,380,200,200,2%0A1,320,100,100,150,2

Caractères spéciaux dans les appels de commande

Pour utiliser les caractères de formatage ou les caractères spéciaux (fin de ligne, espace, accents et tréma, etc.), entrez les caractères de codage URL. Pour ce faire, entrez le caractère % suivi de la valeur hexadécimale du caractère, comme dans les exemples suivants :

Tableau de valeur des couleurs

Pour certains paramètres, des valeurs hexadécimales basées sur celles du rouge, du vert et du bleu (RVB) peuvent être attribuées à chaque couleur. Deux caractères définissent une couleur, 00 correspond à la valeur la plus petite (noir) et FF correspond à la valeur la plus élevée (blanc). Les couleurs sont mélangées les unes aux autres, ainsi 0x000000 donne du noir et 0xFFFFFF du blanc.

Exemple :

La commande control

En premier, vous devez indiquer à la caméra la commande à exécuter.

Commande pour control

La commande rcontrol

Vous devez en premier indiquer au script l'action à exécuter. Selon l'action, il est possible que vous ayez à ajouter des paramètres supplémentaires. Parmi les paramètres supplémentaires, certains sont obligatoires, d'autres sont facultatifs.

Indications :

• Le contenu de ce cadre ne peut être affiché que si l'accès public au droit API est activé dans la boîte de dialogue Contrôle d'accès aux groupes (ACL) ou si le groupe du Nom d'utilisateur correspondant détient ce droit.
• Cette partie de la caméra n'est malheureusement disponible qu'en anglais.