Documentation API

Des instructions détaillées pour l'API REST de Devolutions Server sont disponibles dans la section Applications et outils complémentaires de l'interface web de Devolutions Server, sous Aide et outils – Documentation API.

Voici à quoi ressemble la fenêtre de l'API REST :

Pour vous connecter et utiliser l'API REST, référez-vous au script bash d'exemple ci-dessous. Pour chaque appel API au serveur, assurez-vous de procéder comme suit :

• Remplacez https://url par l'URL spécifique de Devolutions Server.
• Remplacez GUID-OF-VAULT et GUID-OF-ENTRY par les GUID correspondants.

Dans cette version de l'API, les mots de passe ne peuvent être récupérés qu'à partir d'entrées de type Informations d'identification.

# Log in and get the token
authResponse=$(curl -s -X POST "https://url/api/v1/login" \
    -H "Content-Type: application/json" \
    -d '{
        "appKey": "appkey",
        "appSecret": "appsecret"
    }')
token=$(echo $authResponse | jq -r '.tokenId')

# Check if the token was successfully obtained
if [ -z "$token" ] || [ "$token" = "null" ]; then
  echo "Failed to login or obtain token."
  exit 1
fi

# Request data using the token
response=$(curl -s -X GET "https://url/api/v1/vault/GUID-OF-VAULT/entry/GUID-OF-ENTRY" \
    -H "Content-Type: application/json" \
    -H "tokenId: $token")

echo $response | jq

# Log out
curl -s -X POST "https://url/api/v1/logout" \
    -H "Content-Type: application/json" \
    -H "tokenId: $token" \
    -H "Content-Length: 0"