API Document Service

Guide du développeur Genetec Clearance™

Content type
Guides > Guides pour développeurs
Product line
Clearance
ft:locale
fr-FR
Applies to
Clearance

L'API Document Service est un service Web qui prend en charge le transfert de fichiers vers une entité Preuve. Avec l’API Document Service, les utilisateurs peuvent gérer plusieurs fichiers avec différents formats et différentes métadonnées. Les utilisateurs peuvent également effectuer toutes les actions liées aux fichiers associés aux preuves via l’API.

Une entité Preuve représente un seul élément de preuve numérique, mais d'autres fichiers peuvent être nécessaires pour prendre en charge diverses représentations de données ou inclure les métadonnées requises pour les fichiers multimédias.

Par exemple, lorsqu'un fichier vidéo est chargé sur Genetec Clearance™, le système détecte son format et tente de générer un fichier MP4 compatible avec le navigateur pour faciliter la visualisation. La version MP4 est ensuite ajoutée aux preuves en tant que nouvelle ressource.

Documentation interactive sur l'API Document Service

Voir :

Lecture du contenu des preuves :

Lorsque quelqu’un charge une image JPEG, Clearance extrait automatiquement toutes les données Exif stockées au format JPEG. Ensuite, Clearance ajoute un fichier JSON aux preuves qui contiennent les métadonnées extraites afin de simplifier l’affichage de ces informations dans un navigateur.

Tout d'abord, lisons la preuve via l'API REST en utilisant son ID (812) dans le locataire Tenant123. L'ID de preuve est disponible sur l'API Search Service

Requête HTTP GET :

http
GET https://dems-proda-api.clearance.network/documentstore/api/v1/tenant/Tenant123/evidence/812/resource

Le JSON est renvoyé par le service de preuve lors de la demande des ressources associées à une preuve. Le MimeType est image/jpeg pour la photo et genetec/json-exif pour le Exif extrait automatiquement.

json
[
  {
    "ResourceId": "813",
    "EvidenceId": "812",
    "Name": "image-45.jpg",
    "MimeType": "image/jpeg",
    "StartTimeUtc": null,
    "EndTimeUtc": null,
    "TimeOffset": null,
    "UploadedTimeUtc": "2017-09-15T13:55:50.2774484Z",
    "UploadedBy": {
      "KId": "urn:user:tenant123:someone@genetec.com:3",
      "Username": "someone@genetec.com",
      "PrincipalId": "3",
      "PrincipalType": "user"
    },
    "Parent": null,
    "Thumbnail": null,
    "UploadCertificateThumbprint": null,
    "State": "UserCompleted",
    "DecryptedLengthInBytes": 4913685,
    "ConcurrencyId": "13c6023e102d53f26b4210646757b677afa564c2"
  },
  {
    "ResourceId": "828",
    "EvidenceId": "812",
    "Name": "resource_813_exifmetadata.json",
    "MimeType": "genetec/json-exif",
    "StartTimeUtc": null,
    "EndTimeUtc": null,
    "TimeOffset": null,
    "UploadedTimeUtc": "2017-09-15T13:56:06.3157638Z",
    "UploadedBy": {
      "KId": null,
      "Username": "internal",
      "PrincipalId": "0",
      "PrincipalType": null
    },
    "Parent": "813",
    "Thumbnail": "",
    "UploadCertificateThumbprint": null,
    "State": "UserCompleted",
    "DecryptedLengthInBytes": null,
    "ConcurrencyId": "13c6023e102d53f26b4210646757b677afa564c2"
  }
]