Vault Data API

Depuis la version 2025.2 d'Autodesk Vault Professional Server, une nouvelle API REST est disponible pour interagir avec les données du serveur Vault.

Pour vérifier qu'elle fonctionne, vous pouvez pointer votre navigateur web sur l'URL suivante : http(s)://<adresse_ip_ou_nom_du_serveur_vault>/AutodeskDM/Services/api/vault/v2/server-info. Cela devrait retourner des informations sur le serveur Vault (nom du produit et version).

{
  "name": "Vault Professional Server",
  "productVersion": "30.4.28.0"
}

Ce point de terminaison ne demande aucune authentification, mais pour accéder aux données sensibles du serveur Vault, vous devrez utiliser une authentification valide.

Tout comme Vault, plusieurs mécanismes sont supportés :

• Compte Vault
• Compte Windows
• Compte Autodesk

Par exemple, pour se connecter avec un compte Vault, il faut envoyer une requête POST à l'URL suivante : http(s)://<adresse_ip_ou_nom_du_serveur_vault>/AutodeskDM/Services/api/vault/v2/sessions avec les informations d'identification du compte Vault dans le corps de la requête. Avec Postman par exemple, il faut ajouter l'entête Content-Type: application/json et le corps de la requête suivant (body de type raw) :

{
    "input": {
        "vault": "<Le nom du coffre>",
        "userName": "Administrateur",
        "password": "",
        "appCode": "Test"
    }
}

Vous pouvez mettre ce que vous voulez dans appCode, c'est juste pour identifier votre application dans les journaux du serveur Vault.

Les données suivantes vont être retournées si la connexion réussit :

{
  "id": "a8264e29-1a50-4828-88f0-ec125f382bf2",
  "accessToken": "V:a8264e29-1a50-4828-88f0-ec125f382bf2",
  "createDate": "2026-02-25T08:43:39.3277536Z",
  "vaultInformation": {
    "id": "2",
    "name": "<Le nom du coffre>",
    "url": "/AutodeskDM/Services/api/vault/v2/vaults/2"
  },
  "userInformation": {
    "id": "2",
    "name": "Administrateur",
    "systemName": "Administrator",
    "email": "",
    "authTypes": "Vault",
    "createDate": "2025-06-25T07:37:52.213Z",
    "isActive": true,
    "url": "/AutodeskDM/Services/api/vault/v2/users/2"
  },
  "url": "/AutodeskDM/Services/api/vault/v2/sessions/a8264e29-1a50-4828-88f0-ec125f382bf2"
}

Pour envoyer ensuite une requête à un point de terminaison qui nécessite une authentification, il faut inclure le jeton d'accès dans l'en-tête Authorization de la requête.

Par exemple, pour obtenir la liste des fichiers et dossiers se trouvant dans la racine, vous pouvez envoyer une requête GET à l'URL suivante : http(s)://<adresse_ip_ou_nom_du_serveur_vault>/AutodeskDM/Services/api/vault/v2/vaults/{vaultId}/folders/{id}/contents avec l'en-tête Authorization: Bearer V:a8264e29-1a50-4828-88f0-ec125f382bf2.

vaultId c'est l'identifiant du coffre qui est retourné dans vaultInformation/id (2 ici) et id c'est l'identifiant du dossier racine qui est toujours 1. Donc http(s)://<adresse_ip_ou_nom_du_serveur_vault>/AutodeskDM/Services/api/vault/v2/vaults/2/folders/1/contents. Cette requête renvoie des données sous cette forme :

{
  "pagination": {
    "limit": 100,
    "totalResults": 2,
    "indexingStatus": "IndexingComplete"
  },
  "results": [
    {
      "name": "Mon dossier",
      "id": "7",
      "fullName": "$/Mon dossier",
      "category": "Dossier",
      "categoryColor": -2302756,
      "stateColor": 0,
      "subfolderCount": 0,
      "isLibrary": true,
      "isCloaked": false,
      "isReadOnly": false,
      "createDate": "2025-09-24T16:03:51.937Z",
      "createUserName": "Administrateur",
      "entityType": "Folder",
      "url": "/AutodeskDM/Services/api/vault/v2/vaults/2/folders/7"
    },
    ...
  ]
}

Vous avez bien sur d'autres points de terminaison pour obtenir/manipuler les comptes, les options, les propriétés, les fichiers et dossiers, les articles, les ordres de modification, les liens... Vous pouvez également effectuer des recherches et gérer les tâches du processeur de tâches.

Si vous voulez en savoir plus, la documentation se trouve ici.

---

Besoin d'un développement Vault ? Contactez-moi pour un devis gratuit.