Get login history

This example automates the retrieval of the last login events in ONLYOFFICE DocSpace. It extracts unique user IDs from the latest login records, ensuring that duplicate entries are removed.

Before you start

1. Replace https://yourportal.onlyoffice.com and YOUR_API_KEY with your actual DocSpace portal URL and API key. Ensure you have the necessary data and permissions to perform migration operations.
2. Before you can make requests to the API, you need to authenticate. Check out the Personal access tokens page to learn how to obtain and use access tokens.

Full example

Node.js

// Set API base URL
const API_HOST = 'https://yourportal.onlyoffice.com';
const API_KEY = 'your_api_key';

// Headers with API key for authentication
const HEADERS = {
  Accept: 'application/json',
  Authorization: `Bearer ${API_KEY}`,
  'Content-Type': 'application/json',
};

function getLastLoginUsers() {
  const url = `${API_HOST}/api/2.0/security/audit/login/last`;

  return fetch(url, { method: 'GET', headers: HEADERS })
    .then((res) => {
      if (res.status === 200) return res.json();
      return res.text().then((t) => {
        console.log(`Last login users retrieval failed. Status code: ${res.status}, Message: ${t}`);
        return null;
      });
    })
    .then((data) => {
      if (!data) return null;
      const list = data.response || [];
      const userIds = Array.from(new Set(list.map((user) => user.userId)));
      console.log(`Last login users: ${JSON.stringify(userIds)}`);
      return userIds;
    })
    .catch((err) => {
      console.log(`Last login users retrieval error: ${err.message}`);
      return null;
    });
}

// Run
getLastLoginUsers().then((userIds) => {
  console.log(userIds);
});

Python

import requests

# Set API base URL
API_HOST = 'yourportal.onlyoffice.com'
API_KEY = 'your_api_key'

# Headers with API key for authentication
HEADERS = {
  'Accept': 'application/json',
  'Authorization': f'Bearer {API_KEY}',
  'Content-Type': 'application/json'
}

def get_last_login_users():
  url = f'https://{API_HOST}/api/2.0/security/audit/login/last'
  response = requests.get(url, headers=HEADERS)
  if response.status_code == 200:
    res = response.json()
    user_ids = list(set(map(lambda user: user["userId"], res["response"])))
    print(f'Last login users: {user_ids}')
    return user_ids
  else:
    print(f"Last login users retrieval failed. Status code: {response.status_code}, Message: {response.text}")
    return None

if __name__ == "__main__":
  user_ids = get_last_login_users()
  print(user_ids)

How it works

• Fetch last login events - The script sends a GET request to /api/2.0/security/audit/login/last.
• Extract user IDs - It processes the response to collect all user IDs from the login events.
• Remove duplicates - The script ensures that only unique user IDs are stored using set().