Przejdź do głównej treści
Zwraca stronicowaną listę Application posiadanych przez konto lub autoryzowanych do użycia, w tym saldo, status, podsumowanie usługi i powiązane poświadczenia. Nadaje się do zbiorczego monitorowania salda, wyszukiwania Application ID i przechodzenia do zarządzania poświadczeniami.

Przygotowanie

  1. Zaloguj się do platformy AceDataCloud.
  2. Utwórz token konta w konsoli Account Token.
  3. Zwykli użytkownicy używają user_id=me; możesz również pobrać własny UUID z GET /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

Jednoczesne wyświetlanie Application posiadanych przez siebie i autoryzowanych innym przez siebie:

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ść scope to Individual lub Global;
  • rzeczywista wartość type to Usage lub Period.
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.

Następny krok