Utilisation de l’API Synology Surveillance Station

La Surveillance Station de Synology est très complète, elle permet notamment de programmer des plages horaires sur lesquelles activer l’enregistrement ou la détection de mouvement.

Cependant, cette programmation n’est pas toujours suffisante. En effet, je ne souhaite pas être tout le temps enregistré lorsque je suis chez moi; de plus la grande quantité de vidéos produite sera difficile à analyser, classer et nettoyer …

J’ai donc cherché un moyen pour coupler l’enregistrement des caméras avec mon système domotique (qui me sert également de système d’alarme).

L’objectif est de lancer l’enregistrement des caméras lorsque j’active l’alarme et de l’arrêter lorsque je désactive le système d’alarme.

Synology met à disposition une API très bien documentée, même si le principe général est un peu farfelu et difficile à appréhender de prime abord. C’est pourquoi j’écris ce billet : afin de vous simplifier la tâche ! [Sauvegarde locale de la documentation de l’API en version 1.3 2014]

Voici un script écrit en PHP qui permet de lancer l’enregistrement manuel sur toutes les caméras actives sur le système:

<?php

$server = "http://localhost:5000";
$login = "loginSYNO";
$pass = "passwordSYNO";

/* API VERSIONS */
//SYNO.API.Auth
$vAuth = 2;
//SYNO.SurveillanceStation.Camera
$vCamera = 2;
//SYNO.SurveillanceStation.ExternalRecording
$vExternalRecording = 2;

$json = file_get_contents($server.'/webapi/auth.cgi?api=SYNO.API.Auth&method=Login&version='.$vAuth.'&account='.$login.'&passwd='.$pass.'&session=SurveillanceStation&format=sid');
$obj = json_decode($json);
if($obj->success != "true"){
	echo "error";
	exit();
}else{
	//authentification successful
	$sid = $obj->data->sid;
	echo '<p>'.$sid.'</p>';
	
	//list of known cams 
	$json = file_get_contents($server.'/webapi/SurveillanceStation/camera.cgi?api=SYNO.SurveillanceStation.Camera&version='.$vCamera.'&method=list&_sid='.$sid);
	$obj = json_decode($json);

	foreach($obj->data->cameras as $cam){
		$id_cam = $cam->id;
		//check if cam is activated and not recording
		if($cam->enabled && !$cam->recStatus) {
			$json = file_get_contents($server.'/webapi/SurveillanceStation/extrecord.cgi?api=SYNO.SurveillanceStation.ExternalRecording&method=Record&version='.$vExternalRecording.'&cameraId='.$id_cam.'&action=start&_sid='.$sid);
			$obj = json_decode($json);
			if($obj->success != "true"){echo "error set record on cam ".$id_cam;}else echo "<p>Cam ".$id_cam." is recording</p>";
		}
		else{
			echo "<p>Cam " . $id_cam . " skipped</p>";
		}
	}
}

Information : une nouvelle version de ce script pour SurveillanceStation 7 est disponible sur cet article.

Ce script peut être hébergé sur le syno dans la Web Station et permet donc d’activer l’enregistrement sur les caméras à l’aide d’une simple requête HTTP. Vous pourrez facilement alors appeler cette URL depuis votre box domotique préférée (comme une ZiBase par ex) ou votre solution perso en cURL par exemple.