Des instructions détaillées pour l'API REST de Devolutions Server sont disponibles dans la section Documentation de l'API de l'interface Web de Devolutions Server.
Pour se connecter et utiliser l'API REST, se référer au script bash d'exemple ci-dessous. Pour chaque appel API au serveur, s'assurer des éléments suivants :
- Remplacer
https://url
par l'URL spécifique de Devolutions Server. - Remplacer
GUID-OF-VAULT
etGUID-OF-ENTRY
par les GUID correspondants.
Dans cette version de l'API, les mots de passe ne peuvent être récupérés que depuis des entrées de type identifiants.
# 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"