Excellent Banking API: Uwierzytelnianie, endpointy i pierwsze zapytanie

Z przyjemnością otwieramy nowy sposób pracy z Excellent Banking: REST API, które pozwala analizować, kategoryzować i eksportować wyciągi bankowe bezpośrednio z własnych aplikacji, skryptów lub przepływów pracy.

Dla programistów, księgowych obsługujących wielu klientów lub firm, które muszą przetwarzać wyciągi na większą skalę, API eliminuje potrzebę ręcznego przesyłania plików przez aplikację internetową. Wszystko działa przez proste zapytania HTTP.

Co umożliwia API

API obejmuje zasadniczo ten sam proces, który znasz z aplikacji internetowej — ale w pełni zautomatyzowany:

Przesyłaj wyciągi programowo ze swojego backendu lub skryptów automatyzacji
Uruchamiaj przetwarzanie i otrzymuj ustrukturyzowane dane transakcji jako JSON
Pobieraj skategoryzowane pliki Excel gotowe do księgowości, analizy lub importu do Twoich narzędzi
Sprawdzaj status przetwarzania, aby budować niezawodne przepływy pracy oparte na zdarzeniach

Zachowujesz pełną kontrolę. API nie podejmuje decyzji za Ciebie — dostarcza ustrukturyzowany wynik, a Ty decydujesz, co z nim zrobić.

Uwierzytelnianie

Wszystkie wywołania API są uwierzytelniane za pomocą kluczy API. Oto jak to działa:

Pobierz swój klucz z panelu Excellent Banking. Każde konto otrzymuje jeden.
Dołącz go w nagłówku Authorization każdego zapytania.
Wymieniaj go w razie potrzeby — możesz generować nowe klucze w każdej chwili z panelu. Stare klucze są natychmiast unieważniane.

To wszystko. Żadnych tańców z OAuth, żadnej logiki odświeżania tokenów, żadnego skomplikowanego zarządzania sesjami. Jeden klucz, jeden nagłówek i jesteś w środku.

Klucze są ograniczone do Twojego konta, co oznacza, że możesz widzieć i zarządzać tylko swoimi plikami. Jeśli potrzebujesz dostępu na poziomie zespołu lub kont serwisowych, skontaktuj się z nami.

Kluczowe endpointy

API stosuje konwencje REST. Oto koncepcyjny przegląd dostępnych zasobów:

Zasób	Opis
Wyciągi	Przesyłanie wyciągów bankowych (PDF, CSV, obraz), przeglądanie historii, usuwanie plików
Przetwarzanie	Uruchamianie ekstrakcji i kategoryzacji przesłanego pliku
Wyniki	Pobieranie przetworzonych transakcji jako JSON, pobieranie eksportu Excel
Kredyty	Sprawdzanie bieżącego salda, przeglądanie historii użycia
Konto	Zarządzanie profilem i kluczami API

Każda odpowiedź jest w formacie JSON. Każdy endpoint zwraca jasne kody statusu, czytelne komunikaty o błędach i spójną paginację tam, gdzie jest to potrzebne.

Utrzymujemy powierzchnię API małą i skoncentrowaną. Celem jest kilka dobrze zaprojektowanych endpointów pokrywających rzeczywiste przepływy pracy — a nie rozległy katalog, po którym trudno się poruszać.

Twoje pierwsze zapytanie

Oto jak wygląda typowy przepływ integracji:

Uwierzytelnij się — dołącz swój klucz API do nagłówka zapytania
Prześlij — wyślij plik wyciągu bankowego (PDF, CSV lub obraz) za pomocą pojedynczego zapytania multipart
Sprawdź status — przetwarzanie działa asynchronicznie. Odpytuj endpoint statusu lub czekaj na powiadomienia
Pobierz wyniki — po zakończeniu przetwarzania otrzymaj ustrukturyzowane dane transakcji jako JSON
Eksport — poproś o plik Excel, jeśli Twój przepływ pracy go potrzebuje

Cały proces to trzy zapytania: prześlij, sprawdź status, pobierz wyniki. Jeśli wolisz arkusz kalkulacyjny, dodaj czwarte wywołanie, aby pobrać eksport Excel.

Szczegółowe przykłady kodu dla Pythona, JavaScript i cURL są dostępne w dokumentacji API. Dokumentacja zawiera interaktywne konstruktory zapytań, dzięki czemu możesz testować endpointy bezpośrednio w przeglądarce przed napisaniem jakiegokolwiek kodu.

Ceny za korzystanie z API

Wywołania API zużywają kredyty z tego samego salda, którego używasz w aplikacji internetowej. Nie ma oddzielnych cen API ani dodatkowych opłat według zużycia:

Jeden przetworzony wyciąg = jeden lub dwa kredyty (w zależności od rozmiaru)
Te same pakiety kredytów, które już znasz: 5 € za 50, 20 € za 200, 50 € za 700
Kredyty nigdy nie wygasają, niezależnie od tego, czy używasz ich w aplikacji czy przez API
Sprawdź swoje saldo w dowolnym momencie przez endpoint kredytów

Oznacza to, że możesz mieszać sposoby użycia — przesyłać niektóre wyciągi przez interfejs internetowy, a resztę automatyzować przez API. To samo konto, te same kredyty, żadnych niespodzianek.

Prywatność i przetwarzanie danych

Te same gwarancje prywatności, które obowiązują w aplikacji internetowej, dotyczą również API:

Wszystkie dane pozostają w UE (Niemcy i Szwajcaria)
Pełna zgodność z RODO
Twoje dane nigdy nie są wykorzystywane do trenowania
Pełne usunięcie dostępne na żądanie w dowolnym momencie
Klucze API są przesyłane wyłącznie przez HTTPS

Jeśli tworzysz integracje przetwarzające dane bankowe, możesz mieć pewność, że nasza infrastruktura spełnia europejskie standardy ochrony danych.

Co dalej z API?

To pierwsza wersja API i aktywnie ją ulepszamy na podstawie opinii. Na krótkoterminowej mapie drogowej:

Webhooki, aby Twoja integracja nie musiała odpytować statusu
Przetwarzanie wsadowe do przesyłania wielu wyciągów w jednym wywołaniu
Więcej formatów wyjściowych poza Excel i JSON
Niestandardowe reguły kategoryzacji, które możesz stosować przez API

API rozwija się wraz z Twoimi potrzebami. Jeśli jakaś konkretna funkcja lub endpoint byłby dla Ciebie przydatny, daj nam znać.

Zacznij

Przejdź do swojego panelu, pobierz swój klucz API i zapoznaj się z pełną dokumentacją. Twoje pierwsze zapytanie jest w zasięgu kilku minut.

Jeśli napotkasz problemy lub masz pytania, jesteśmy pod adresem hello@excellent-banking.com.