Table of Contents   MOBOTIX Online Help

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.

Modification des paramètres du menu Configuration

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

Exécution des fonctions de la caméra

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

Attention : certaines fonctions pour sauvegarder et restaurer la configuration ne peuvent être exécutées que par un utilisateur du niveau admin. Si tel est le cas, vous devez exécuter le script rcontrol via une autre commande HTTP :
http://128.243.66.90/admin/rcontrol

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://128.243.66.90/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://128.243.66.90/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://128.243.66.90/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://128.243.66.90/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://128.243.66.90/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 :

Caractère Codage URL Caractère Codage URL Caractère Codage URL
(fin de ligne) %0A (espace) %20 ou + % %25
& %26 + %2B = %3D
? %3F © %A9 ® %AE
ß %DF ä %e4 Ä %c4
ö %F6 Ö %D6 ü %FC
Ü %DC Ç %c7 à %e0
á %e1 â %E2 æ %E6
ç %E7 è %E8 é %E9
ê %EA ë %EB î %ee
ï %EF ô %F4 ù %F9
ú %FA ù %FB û %fc

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 :

0xFF0000 Rouge
0x00FF00 Vert
0x0000FF Bleu

Nom de la couleur Hexadécimal Couleur Nom de la couleur Hexadécimal Couleur
Noir 0x000000   Bordeaux 0x800000  
Vert foncé 0x008000   Olive 0x808000  
Bleu marine 0x000080   Mauve 0x800080  
Aigue-marine 0x008080   Gris foncé 0x808080  
Gris clair 0xC0C0C0   Rouge 0xFF0000  
Vert 0x00FF00   Jaune 0xFFFF00  
Bleu 0x0000FF   Magenta 0xFF00FF  
Cyan 0x00FFFF   Blanc 0xFFFFFF  

La commande control

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

Commande pour control

Commande Description
set Accès en écriture aux paramètres d'image. Cette commande vous permet de modifier les paramètres d'image.
http://128.243.66.90/control/control?set
read Accès en lecture aux paramètres d'image. Cette commande vous permet de consulter des informations pour les paramètres d'image.
http://128.243.66.90/control/control?read
list

La commande list permet de consigner les paragraphes modifiables du fichier de configuration.
Pour obtenir les paramètres d'un paragraphe, étendez la requête avec section=<nomduparagraphe>.

Exemple :
http://128.243.66.90/control/control?list&section=actions permet d'établir la liste des options du paragraphe actions.

Cette commande permet de lire les valeurs actuelles et d'afficher les options et les textes affichés avec d'autres programmes.

factory La commande factory permet de réinitialiser les paramètres d'un paragraphe selon la configuration par défaut. Cette requête nécessite le nom de paragraphe section=<nomduparagraphe>.
<code>http://128.243.66.90/control/control?<b>factory</b>&section=<nomduparagraphe></code>
restore La commande restore permet de réinitialiser les paramètres d'un paragraphe selon les valeurs enregistrées en dernier dans la mémoire Flash. Cette requête nécessite le nom de paragraphe section=<nomduparagraphe>.
http://128.243.66.90/control/control?restore&section=<nomduparagraphe>



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 :


Indication :

La commande list située dans la ligne d'adresse de votre navigateur vous permet d'afficher toutes les options de la commande rcontrol :
http://128.243.66.90/control/rcontrol?list.

cn, de, en, es, fr, it, jp, ru

© 2001-2017 MOBOTIX AG, Germany · http://www.mobotix.com/