Korzystając z frameworka aplikacji, możesz tworzyć aplikacje na platformie monday.com. Rozszerzają one podstawowe funkcje platformy, uzupełniają jej braki i pozwalają dostosować przepływy pracy.

Aplikacje możesz udostępniać wybranym kontom, publikować w marketplace aplikacji, aby były dostępne dla wszystkich użytkowników monday.com, albo zachować jako prywatne w obrębie konta. Tworzy się nimi i zarządza w Developer Center.

Zapytania

Pobierz aplikację

• Zwraca obiekt zawierający metadane aplikacji.
• Można wykonać to zapytanie bezpośrednio na głównym poziomie albo zagnieździć je w zapytaniu daily_analytics.

query {
  platform_api {
    daily_analytics {
      by_app {
        app {
          name
          features {
            type
            name
          }
          id
          api_app_id
          state
        }
        usage
      }
    }
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($appId: ID!) { app (id: $appId) { features { id type } } }`;
const variables = {
  appId: 1234567890,
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
id	ID!	Unikalny identyfikator aplikacji.

Pola

Pole	Typ	Opis	Wartości wyliczeniowe
account_id	ID	Identyfikator konta aplikacji.
api_app_id	ID	Unikalny identyfikator aplikacji w API.
client_id	String	Unikalny identyfikator aplikacji w API.
collaborators	[User!]	Współpracownicy aplikacji.
created_at	Date	Data utworzenia aplikacji.
created_by	ID	Unikalny identyfikator użytkownika, który utworzył aplikację.
description	String	Opis aplikacji.
features	[AppFeatureType!]	Funkcje aplikacji.
id	ID!	Unikalny identyfikator aplikacji.
kind	String	Rodzaj aplikacji.
name	String	Nazwa aplikacji.
permissions	[String!]	Uprawnienia aplikacji.
photo_url	String	Adres URL zdjęcia aplikacji.
photo_url_small	String	Adres URL małego zdjęcia aplikacji.
slug	String	Slug aplikacji.
state	String	Stan aplikacji (aktywna/nieaktywna).
status	AppStatus	Status aplikacji.	DRAFT LIVE
updated_at	Date	Data ostatniej aktualizacji aplikacji.
user_id	ID	Unikalny identyfikator użytkownika, który utworzył aplikację.
version_type	String	Typ najnowszej wersji aplikacji.
versions	[DeveloperAppVersion!]	Wersje aplikacji. To pole przydaje się do sprawdzania statusu wersji, która jest promowana. Dostępne tylko w wersjach 2026-10 i nowszych.
webhook_url	String	Adres URL punktu końcowego webhooka aplikacji.

Mutacje

Utwórz aplikację

Tworzy nową aplikację. Zwraca obiekt App.

mutation {
  create_app(
    input: {
      collaborators: [54321, 12345],
      description: "The updated app description.",
      name: "The updated app name.",
      kind: PUBLIC,
      permissions: ["docs:write", "me:read"]
    }
  ) {
    description
    name
    kind
    permissions
    collaborators {
      id
    }
  }
}

Argumenty

Argument	Typ	Opis
input	CreateAppInput!	Obiekt zawierający dane konfiguracji nowej aplikacji.

Zaktualizuj aplikację

Aktualizuje aplikację. Zwraca obiekt App.

:construction: Działa tylko w przypadku współpracowników aplikacji

mutation {
  update_app(
    id: 123456,
    input: {
      collaborators: [54321, 12345],
      description: "The updated app description.",
      name: "The updated app name."
    }
  ) {
    description
    name
    collaborators {
      id
    }
  }
}   

Argumenty

Argument	Typ	Opis
id	ID!	Unikalny identyfikator aplikacji do zaktualizowania.
input	UpdateAppInput!	Obiekt zawierający zaktualizowane dane konfiguracji aplikacji.

---

Promuj aplikację

Rozpoczyna promowanie wersji roboczej aplikacji do wersji aktywnej. Jest to operacja asynchroniczna - jej ukończenie może zająć kilka sekund. Zwraca obiekt DeveloperAppVersion, którego możesz użyć do sprawdzania statusu promocji.

Aby sprawdzić, czy promocja została ukończona, odpytuj zapytanie app i sprawdzaj versions[].status, aż zmieni się z PROMOTING na LIVE.

📘 UWAGA

Tę mutację mogą wykonać tylko współpracownicy aplikacji.

mutation {
  promote_app(
    app_id: "1234567890"
  ) {
    id
    status
  }
}

# Poll app versions after promoting
query {
  app(id: "1234567890") {
    id
    name
    versions {
      id
      status
    }
  }
}

Argumenty

Argument	Typ	Opis
app_id	ID!	Unikalny identyfikator aplikacji do promowania.
app_version_id	ID	Identyfikator konkretnej wersji roboczej do promowania. Jeśli go nie podasz, zostanie promowana najnowsza wersja robocza.