Przygotowanie
- Zaloguj się do platformy AceDataCloud.
- Utwórz token konta w konsoli Account Token.
- Zwykli użytkownicy używają
user_id=me; możesz również pobrać własny UUID zGET /api/v1/platform-tokens/me/.
Przegląd interfejsu
Zwykli użytkownicy powinni przekazać
user_id=me. Bez jego przekazania zapytanie nie zostanie najpierw zawężone według konta, a paginacja może zwrócić 403 po napotkaniu obiektów bez uprawnień; administratorzy bez jego przekazania mogą przeglądać całą tabelę.
Parametry zapytania
paid, disabled, expired, low_balance i tag nie są obecnie parametrami filtrowania po stronie serwera. Alerty salda powinny po pobraniu listy być oceniane po stronie klienta na podstawie remaining_amount, service.unit i progów biznesowych każdego Application.
Przykład żądania
Opis odpowiedzi
Odpowiedź ma postać{count, items}. Każda pozycja zawiera pola modelu Application oraz dodatkowo:
service:id,alias,title,type,unit,icon_url;credentials: podsumowanie poświadczeń, które aktualny wywołujący ma prawo zobaczyć;paid,remaining_amount,used_amount,disabled,allow_consume_global,allow_overdraft;- rzeczywista wartość
scopetoIndividuallubGlobal; - rzeczywista wartość
typetoUsagelubPeriod.
allow_overdraft jest polem logicznym tylko do odczytu kontrolowanym przez administratora, domyślnie ustawionym na false. W przypadku aplikacji rozliczanych według użycia (Usage) z włączonym debetem niewystarczające saldo nie blokuje wywołań, a opłaty są nadal naliczane według rzeczywistego użycia; ujemne saldo oznacza limit oczekujący na rozliczenie. Wyłączenie, wygaśnięcie i limity poświadczeń API nadal obowiązują.
remaining_amount może być puste; klient musi najpierw sprawdzić, czy wartość nie jest pusta, a dopiero potem wykonać porównanie liczbowe. Jednostkę limitu określa service.unit.

