Dokumentacja dla programistów›API Marketplace›Operacje subskrypcji aplikacji
Dokumentacja dla programistów

Operacje subskrypcji aplikacji

API MarketplaceDokumentacja API
Aktualizacja 2026-09-06

Monetization by monday oferuje dwa modele cenowe aplikacji: oparty na funkcjach i oparty na liczbie miejsc. W przypadku modelu opartego na funkcjach ważne jest śledzenie liczby operacji wykonywanych przez aplikację, aby nie przekroczyły przyznanego limitu.

Obiekt app_subscription_operations oraz powiązane z nim zapytania i mutacje pozwalają śledzić użycie, zliczając operacje według typu (kind) i konta. W przypadku subskrypcji rocznych i miesięcznych licznik zeruje się co miesiąc w dniu odnowienia subskrypcji. Na przykład jeśli subskrypcja odnawia się co roku 15. dnia miesiąca, licznik będzie zerować się 15. dnia każdego miesiąca.

Za pomocą mutacji increase_app_subscription_operations możesz zwiększyć licznik operacji na podstawie użycia na koncie, a następnie odczytać zaktualizowane wartości za pomocą zapytania app_subscription_operations. Te zapytania i mutacje działają tylko z tokenami dostępu wygenerowanymi dla aplikacji, a konto musi mieć aktywną subskrypcję aplikacji. Tokeny dostępu dla deweloperów nie będą działać.

Zapytania

Pobieranie operacji subskrypcji aplikacji

  • Zwraca obiekt zawierający liczbę operacji dla aplikacji korzystających z modelu opartego na funkcjach
  • Można go odpytywać tylko bezpośrednio w korzeniu zapytania; nie można go zagnieżdżać w innym zapytaniu
 query {
  app_subscription_operations(kind: "image_scan") {
    counter_value
    period_key
   }
 }
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = "query ($operationKind: String!) { app_subscription_operations (kind: $operationKind) { counter_value period_key }}"
const variables = {
  operationKind: "image_scan",
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument Typ Opis
kind String Nazwa operacji.

Pola

Pole Typ Opis
app_subscription [AppSubscription] Szczegóły subskrypcji aplikacji na koncie.
counter_value Int Nowa wartość licznika. Licznik zeruje się na początku każdego nowego okresu subskrypcji aplikacji.
kind String! Nazwa operacji.
period_key String Unikatowy identyfikator okresu (powiązany z okresami subskrypcji).

Mutacje

Zwiększanie liczby operacji w subskrypcji aplikacji

Zwiększa licznik dla określonej operacji. Zwraca obiekt AppSubscriptionOperationsCounter.

Jeśli dla przekazanego tokena nie istnieje aktywna subskrypcja, zwróci błąd.

 mutation {
  increase_app_subscription_operations(
    kind: "image_scan"
    increment_by: 2
  ){
    counter_value
   }
 }
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = "mutation ($operationKind: String!, $value: Int!) { increase_app_subscription_operations (kind: $operationKind, increment_by: $value) { counter_value }}"
const variables = {
  operationKind: "image_scan",
  value: 2
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Jeśli pominiesz te argumenty, domyślnie zostanie użyta globalna wartość kind, a licznik zwiększy się o 1.

Argument Typ Opis
increment_by Int Wartość, o którą ma zostać zwiększony licznik. Musi być liczbą dodatnią.
kind String Ciąg alfanumeryczny o długości do 14 znaków, który może zawierać symbole - i _.