Skip to main content
Pobierz bezpośrednio szczegóły wywołań API bieżącego konta jako CSV, co jest odpowiednie do uzgadniania finansowego, analizy offline lub zapisywania dużej liczby rekordów. Jeśli potrzebujesz jedynie wyświetlić niewielką liczbę szczegółów na stronie, najpierw użyj listy rekordów wywołań.

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 ID filtrów 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 do wywoływania biznesowych API nie można używać zamiennie.

Przegląd interfejsu

Ten interfejs synchronicznie strumieniuje odpowiedź CSV, nie tworzy zadania eksportu ani nie zwraca JSON lub linku do pobrania. Tylko gdy zarówno czas początkowy, jak i końcowy nie zostały podane, domyślnie eksportowane są rekordy od początku bieżącego miesiąca kalendarzowego do bieżącej chwili; gdy podano tylko jedną granicę, druga strona nie jest automatycznie uzupełniana 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 faktycznego wywołującego; eksport między kontami nie jest obsługiwany.

Przykłady żądań

Zapisz bezpośrednio CSV za bieżący miesiąc:
Eksportuj według Application, czasu i kodu statusu:
Strumieniowe zapisywanie w Pythonie i sprawdzanie kompletności:

Kolumny CSV

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

Określanie, czy eksport jest kompletny

Pojedyncze wywołanie może zwrócić 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 segmentami w mniejszych oknach czasowych.
  • # error:: odczyt strumieniowy został przerwany; po zmniejszeniu zakresu wyeksportuj ponownie.
Gdy program uzgadniający wykryje dowolny marker, musi uznać plik za niekompletny i nie może księgować go bez powiadomienia.

Błędy i ponawianie prób

Następny krok