Résultat de classification

Le résultat de classification est renvoyé par :

• POST /api/classify?sync=true
• GET /api/result/{id}
• Webhooks lorsque la livraison webhook est configurée

Exemples

Clé API manquante (403)

{
  "success": false,
  "error": "no access to current endpoint, make sure you are using correct API key"
}

Réponse asynchrone

{
  "id": "6662efdb5200108549e3ac2b",
  "accepted_at": "2024-06-07T13:32:43.811+02:00"
}

Réponse synchrone

{
  "id": "6662f5c1f897618de43f0bbd",
  "status": {
    "classify": "accepted",
    "video": "accepted"
  },
  "camera_id": "134188-VI08",
  "tenant": "test",
  "duration": 1434714,
  "duration_seconds": 1,
  "model": "noname",
  "version": "2.0.16123",
  "error_code": 0,
  "error_msg": "",
  "risk": "",
  "labels": ["intrusion"],
  "scores": {
    "person": 0.127,
    "vehicule": 0.893,
    "intrusion": 0.919,
    "flag": 0.830,
    "animal": 0.062,
    "plant": 0.049,
    "other": 0.020,
    "wind": 0.007,
    "rain": 0.005,
    "web": 0.004,
    "spider": 0.003,
    "text": 0.001,
    "NOTHING": 0.0003
  },
  "video": {
    "videoname": "video.mp4",
    "filesize": 246792,
    "specs": {
      "duration": 2.3,
      "fps": 2.61,
      "original.fps": 3,
      "original.height": 480,
      "original.width": 640,
      "width": 426,
      "height": 320,
      "nframes": 6,
      "original.nframes": 6
    }
  },
  "metadata": {
    "parc_origine": "XX",
    "client_id": 134188,
    "code_msg": "VI08",
    "no_trans": "20818"
  },
  "created_at": "2024-06-07T13:57:55.230+02:00",
  "started_at": "2024-06-07T13:57:55.230+02:00"
}

Informations de base

Champ	JSON	Description
ID	id	Identifiant unique du résultat (classify_id).
CameraID	camera_id	Identifiant de caméra, dérivé des métadonnées.
Tenant	tenant	Identifiant du tenant (obligatoire).
Model	model	Modèle utilisé pour la classification (optionnel).
Version	version	Version du modèle (optionnel).

Le camera_id est généré à partir des métadonnées :

camera_id = metadata.client_id + metadata.camera_id
camera_id = metadata.client_id + metadata.code_msg   // repli

Durée

Champ	Type	JSON	Description
Duration	int64	duration	Durée de la classification en millisecondes.
DurationSeconds	int	duration_seconds	Durée de la classification en secondes.

Statut et erreurs

Champ	Type	JSON	Description
Status	object	status	Statut imbriqué pour le traitement de classification et vidéo.
ErrorCode	int	error_code	Code d’erreur (0 = succès).
ErrorMessage	string	error_msg	Message d’erreur détaillé.

Constantes de statut

Valeur	Description
accepted	L’analyse a été acceptée.
in-progress	L’analyse est en cours.
done	L’analyse est terminée.
error	Une erreur s’est produite pendant l’analyse.
timeout	L’analyse a expiré.

Résultats de l’analyse

Champ	Type	JSON	Description
Risk	string	risk	Niveau de risque : safe, danger ou intrusion.
Labels	string[]	labels	Labels attribués par l’analyse.
Scores	object	scores	Scores de confiance par label (0.0–1.0).

Voir Risque, labels et scores pour savoir comment les scores déterminent les niveaux de risque.

Détails vidéo

Champ	Type	JSON	Description
Videoname	string	videoname	Nom du fichier vidéo.
Filesize	int	filesize	Taille du fichier vidéo en octets.
VideoSpecs	object	specs	Spécifications vidéo (résolution, fps, nombre de trames).

Horodatages

Champ	Type	JSON	Description
CreatedAt	time	created_at	Date de création de l’analyse.
StartedAt	time	started_at	Date de démarrage de l’analyse.

Métadonnées

Champ	Type	JSON	Description
Metadata	object	metadata	Données supplémentaires optionnelles. Voir Métadonnées.