Dokumentacja dla programistów

Subskrypcje aplikacji

API MarketplaceDokumentacja API
Aktualizacja 2026-09-06

Monetyzacja aplikacji wykorzystuje subskrypcje jako umowę rozliczeniową między użytkownikiem a aplikacją. Każda subskrypcja zawiera unikalne dane dotyczące częstotliwości rozliczeń użytkownika, typu planu i okresu odnowienia.

Zapytania

Pobieranie subskrypcji aplikacji

  • Działa tylko w przypadku współpracowników aplikacji
  • Limit: 120 razy na minutę
  • Zwraca tablicę zawierającą dane o wszystkich subskrypcjach aplikacji
  • Można ją wykonać bezpośrednio tylko na poziomie głównym; nie można umieścić jej w innym zapytaniu

Jeśli chcesz pobrać subskrypcję konkretnego konta z poziomu aplikacji, użyj obiektu app_subscription.

query {
  app_subscriptions(app_id: 1234567890) {
    cursor
    total_count 
    subscriptions {
      account_id
      monthly_price
      currency
      max_units
    }
  }
}
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = "query($appId:ID!) { app_subscriptions (app_id: $appId) { cursor total_count subscriptions { account_id monthly_price currency } } }";
const variables = {
  appId: 123456789,
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Pola Typ Opis Wartości wyliczeniowe
account_id Int Unikalny identyfikator konta.
app_id ID! Unikalny identyfikator aplikacji.
cursor String Nieprzezroczysty token wskazujący pozycję w zbiorze wyników, od której należy pobrać subskrypcje. Użyj go do stronicowania dużych zbiorów wyników.
limit Int Liczba subskrypcji do zwrócenia. Wartość domyślna to 100, a maksymalna to 500.
status SubscriptionStatus Status subskrypcji. active
inactive

Pola

Pola Typ Opis
cursor String Nieprzezroczysty kursor wskazujący pozycję na liście po ostatniej zwróconej subskrypcji. Użyj go do stronicowania i pobrania następnego zestawu subskrypcji. Jeśli kursor ma wartość null, nie ma już kolejnych subskrypcji do pobrania.
subscriptions [AppSubscriptionDetails!]! Szczegółowe informacje o subskrypcjach aplikacji.
total_count Int! Łączna liczba subskrypcji.