Dokumentacja dla programistów

Instalacje aplikacji

API aplikacjiDokumentacja API
Aktualizacja 2026-09-06

Za każdym razem, gdy użytkownik monday.com instaluje aplikację, wysyłamy informacje o instalacji jej deweloperowi, aby mógł lepiej zrozumieć jej wydajność i sposób użycia. Informacje te są dostępne za pomocą webhooków oraz zapytania app_installs.

Zapytania

Pobieranie instalacji aplikacji

  • Działa tylko dla współpracowników aplikacji używających tokena osobistego
  • Zwraca obiekt zawierający szczegóły instalacji aplikacji
  • Można go wykonać bezpośrednio tylko na poziomie głównym - nie można zagnieżdżać go w innym zapytaniu
query {
  app_installs(
    app_id: 123456789
    account_id: 98766543210
    ) {
    app_id
    timestamp
    app_install_account {
      id
    }
    app_install_user {
      id
    }
    app_version {
      major
      minor
      patch
      type
      text
    }
    permissions {
      approved_scopes
      required_scopes
    }
  }
}
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($appId: ID!, $accountId: ID!) { app_installs (app_id: $appId, account_id: $accountId) { app_id timestamp app_install_account { id } app_install_user { id } app_version { major minor patch type text } permissions { approved_scopes required_scopes }}}`;
const variables = {
  appId: 123456789,
  accountId: 9876543210
}

const response = await mondayApiClient.request(query, variables);

Argumenty

Argument Typ Opis
account_id ID Unikalny identyfikator konta, według którego filtrowane są wyniki.
app_id ID! Unikalny identyfikator aplikacji, według którego filtrowane są wyniki.
limit Int Liczba tablic, które mają zostać zwrócone. Domyślnie 25, maksymalnie 100.
page Int Numer strony do zwrócenia. Numeracja zaczyna się od 1.

Pola

Pola Typ Opis
app_id Int! Unikalny identyfikator aplikacji.
app_install_account AppInstallAccount! Szczegóły konta osoby instalującej aplikację.
app_install_user AppInstallUser! Szczegóły użytkownika instalującego aplikację.
app_version AppVersion Szczegóły wersji aplikacji w momencie jej instalacji.
permissions AppInstallPermissions Wymagane i zatwierdzone zakresy uprawnień instalacji.
timestamp String Data i godzina instalacji aplikacji.