Przejdź do głównej treści
Pobierz szczegóły wywołań API bieżącego konta bezpośrednio jako CSV — odpowiednie do uzgadniania finansowego, analizy offline lub przechowywania dużych ilości rekordów. Jeśli potrzebujesz tylko wyświetlić niewielką liczbę szczegółów na stronie, najpierw użyj listy historii wywołań. Zakres zapytań dotyczących historii 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 rzeczywistej opłaty, użycia ani statystyk zbiorczych tego rekordu.

Przygotowanie

  1. Zaloguj się do platformy AceDataCloud.
  2. Utwórz token konta w konsoli Account Token i natychmiast zapisz go w menedżerze haseł lub Secret Manager.
  3. W razie potrzeby pobierz identyfikatory filtrowania 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. Tokenu konta i Credential używanego do wywoływania biznesowego API nie można stosować zamiennie.

Przegląd interfejsu

Ten interfejs synchronicznie zwraca strumieniowo CSV, nie tworzy zadania eksportu ani nie zwraca JSON lub linku do pobrania. Tylko gdy nie podano zarówno czasu początkowego, jak i końcowego, domyślnie eksportowane są rekordy od początku bieżącego miesiąca kalendarzowego do bieżącej chwili; gdy podano tylko jedną granicę, druga granica nie zostanie automatycznie uzupełniona granicą bieżącego miesiąca.

Parametry zapytania

Zakres eksportu jest zawsze ograniczony do rekordów widocznych dla bieżącego konta jako podmiotu płatniczego i/lub rzeczywistego wywołującego; eksport między kontami nie jest obsługiwany.

Przykłady żądań

Bezpośrednie zapisanie CSV bieżącego miesiąca:
Eksport według Application, czasu i kodu statusu:
Strumieniowy zapis w Pythonie i sprawdzanie kompletności:

Kolumny CSV

Kolejność nagłówków CSV jest stała:
Jednostka limitu jest określana przez service.unit odpowiedniego Application.

Określanie, czy eksport jest kompletny

Jednorazowo można wyprowadzić maksymalnie 1 000 000 rekordów. Gdy serwer rozpoczął już zwracanie CSV, nie może zmienić błędu występującego w trakcie na inny status HTTP, dlatego klient musi sprawdzić ostatnią linię:
  • # truncated:: osiągnięto limit liczby wierszy; eksportuj partiami w mniejszych oknach czasowych.
  • # error:: przerwano odczyt strumieniowy; zmniejsz zakres i ponownie wyeksportuj.
Gdy program uzgadniający zobaczy dowolny marker, musi traktować plik jako niekompletny i nie może go po cichu zaksięgować.

Błędy i ponawianie prób

Następny krok