Dokumentacja dla programistów
Subskrypcje aplikacji
API MarketplaceDokumentacja API
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. | activeinactive |
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. |