Przejdź do głównej treści
Agreguje liczbę żądań i faktycznie odliczone limity bieżącego konta według daty i API, odpowiednie do tworzenia raportów miesięcznych, wykresów trendów i analiz kosztów. Gdy wymagane jest indywidualne rozwiązywanie problemów, użyj listy rekordów wywołań; gdy wymagane są pełne szczegóły offline, użyj eksportu użycia. Zakres zapytań dotyczących rekordów wywołań i podsumowań rozliczeń obejmuje ostatnie 60 dni; treści żądań i odpowiedzi są przechowywane oddzielnie przez ostatnie 30 dni. Wygaśnięcie treści nie zmienia faktycznych opłat, użycia ani zagregowanych statystyk tego rekordu.

Przygotowanie

  1. Zaloguj się do platformy AceDataCloud.
  2. Utwórz token konta w konsoli Account Token i natychmiast go zapisz.
  3. Aby zawęzić zakres, pobierz odpowiednie ID z listy wniosków o usługę, listy poświadczeń API lub listy API.
Pełny opis tokenów znajdziesz w zarządzaniu tokenami konta. Ten interfejs używa Account Token, a nie biznesowego Credential.

Przegląd interfejsu

Parametry zapytania

start_time / end_time nadal mogą być używane jako kompatybilne aliasy dla starszych klientów; nowe integracje jednolicie używają created_at_from / created_at_to. Forma daty created_at_to obejmuje ten dzień kalendarzowy, czyli jako granicę stosowana jest północ następnego dnia.

Przykłady żądań

Zapytaj o dzienne/API podsumowanie bieżącego miesiąca w czasie pekińskim wraz z wymiarem modelu:
Zapytaj o tygodniowe użycie wskazanego Application:
Przykład w Pythonie:

Przykład odpowiedzi

Pola odpowiedzi

Jednostka limitu zależy od service.unit powiązanego Application. Jeśli zapytanie obejmuje usługi o różnych jednostkach, najpierw wykonaj oddzielne statystyki według service_id lub application_id, aby uniknąć bezpośredniego porównywania lub dodawania. Gdy czas końcowy nie jest późniejszy niż czas początkowy, interfejs zwraca kompletną pustą strukturę: items=[], total=0, apis={}, requests=0, models=[].

Zalecenia dotyczące błędów i wydajności

  • Domyślnie nie włączaj include_models; włącz je tylko wtedy, gdy raport rzeczywiście wymaga podziału według modelu.
  • W przypadku zapytań o duży zakres w pierwszej kolejności rozdziel je według service_id lub application_id, aby zarówno uniknąć mieszania jednostek, jak i zmniejszyć koszt zapytania.
  • Daty bez wywołań nie są automatycznie uzupełniane zerami; przed rysowaniem wykresu klient powinien uzupełnić oś dat.

Następny krok