Documentación de la API

Las instrucciones detalladas sobre la API REST de Devolutions Server están disponibles en la sección Aplicaciones y herramientas complementarias de la interfaz web de Devolutions Server, en Ayuda y herramientas – Documentación de la API.

Este es el aspecto de la ventana de la API REST:

Para conectarse y utilizar la API REST, consulte el script bash de ejemplo que figura a continuación. Para cada llamada a la API del servidor, asegúrese de lo siguiente:

• Sustituya https://url por la URL específica de Devolutions Server.
• Sustituya GUID-OF-VAULT y GUID-OF-ENTRY por los GUID correspondientes.

En esta versión de la API, las contraseñas solo se pueden recuperar de entradas del tipo Credenciales. Tenga en cuenta que las entradas de subtipo (PasswordList, por ejemplo) no son compatibles.

# 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"