Aller au contenu
Lexoh API

API des caméras et de la vidéo

OpenAPI JSON

Consulter les caméras et les événements enregistrés

Les données et les médias des caméras utilisent les routes /v1/camera. Les réponses JSON et les réponses vidéo binaires sont des types de contenu distincts.

POST /v1/camera/list

Lister les caméras

Permissions requises

  • can_view_cameras

L’authentification, la MFA et les restrictions de portée restent applicables.

Nécessite can_view_cameras. Transmettez un objet JSON vide pour consulter les caméras. La réponse contient success, cameras et count; cette opération n’utilise pas les champs de pagination de la liste des appareils.

Exemple de requête

curl -X POST "https://your-lexoh-server.app.lexoh.com:3000/v1/camera/list" \
  -H "SessionID: SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Exemple de réponse

Exemple sans caméra.

{
  "success": true,
  "cameras": [],
  "count": 0
}

POST /v1/camera

Consulter une caméra et son champ stream

Permissions requises

  • can_view_cameras

L’authentification, la MFA et les restrictions de portée restent applicables.

Une réponse réussie contient camera. Son champ stream fournit l’URL de signalisation WebRTC lorsqu’un moniteur est configuré; sinon, ce champ est vide. Traitez les détails des caméras et les URL de diffusion comme des données sensibles.

Exemple de requête

curl -X POST "https://your-lexoh-server.app.lexoh.com:3000/v1/camera" \
  -H "SessionID: SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":123}'

POST /v1/camera/event/list

Lister les événements des caméras

Permissions requises

  • can_view_camera_events

L’authentification, la MFA et les restrictions de portée restent applicables.

Nécessite can_view_camera_events. La réponse contient success, events et count. page commence à 1; page_limit vaut 25 par défaut et est plafonné à 500.

Exemple de requête

curl -X POST "https://your-lexoh-server.app.lexoh.com:3000/v1/camera/event/list" \
  -H "SessionID: SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"page":1,"page_limit":25}'

Exemple de réponse

Exemple sans événement de caméra correspondant.

{
  "success": true,
  "events": [],
  "count": 0
}

GET /v1/camera/event/clip/EVENT_ID

Télécharger un extrait d’événement disponible

Remplacez EVENT_ID par l’identifiant de l’événement enregistré. Nécessite can_view_camera_events. Une réponse réussie retourne video/mp4, et non une URL de flux en JSON.

Exemple de requête

curl -X GET "https://your-lexoh-server.app.lexoh.com:3000/v1/camera/event/clip/EVENT_ID" \
  -H "SessionID: SESSION_TOKEN"

Vidéo HLS enregistrée

GET /v1/camera/event/vod/EVENT_ID/master.m3u8 retourne une liste de lecture HLS disponible. La même route avec le nom du segment demandé retourne du contenu video/MP2T. Ces requêtes nécessitent une session authentifiée et la permission de consulter les événements des caméras.

Consulter les événements opérationnels

Filtrez les événements et paginez les résultats.

API des événements →
Appeler Lexoh 1-888-401-8019