Połączone aplikacje i deweloperzy

Pozwól innej aplikacji, z której korzystasz — na przykład programowi księgowemu — pracować z Twoimi wydatkami w AI Budget, sprawdź dokładnie, co może robić, i odetnij jej dostęp jednym dotknięciem. Deweloperzy mogą budować takie aplikacje na API AI Budget.

Co oznacza połączenie aplikacji

Niektóre produkty potrafią pracować z Twoimi danymi z AI Budget na własnych ekranach: aplikacja księgowa może pobierać Twoje wydatki i paragony albo dodawać wydatki za Ciebie. Żeby na to pozwolić, łączysz aplikację z jednym lub kilkoma swoimi kontami w AI Budget.

Aplikacja nigdy nie widzi Twojego hasła. Gdy klikniesz w niej przycisk „Połącz z AI Budget”, przeniesie Cię na stronę AI Budget, gdzie logujesz się jak zwykle i widzisz:

• nazwę aplikacji, jej stronę i to, kto ją stworzył;
• Zweryfikowana przez AI Budget (aplikacja, którą sprawdziliśmy, na przykład nasza własna) albo Niezweryfikowana przez AI Budget;
• listę uprawnień, o które prosi aplikacja;
• Konta do połączenia — przy każdym koncie pole wyboru. Zaznacz każde konto, z którego aplikacja może korzystać; Zezwól pozostaje nieaktywne, dopóki nie zaznaczysz co najmniej jednego. Jeśli można połączyć tylko jedno konto, jest już zaznaczone. Konta, które możesz tylko przeglądać, albo z pełnym szyfrowaniem są wyszarzone z podaniem powodu, a konto z szyfrowaniem tekstu jest oznaczone jako tylko do odczytu.

Dotknij Zezwól, żeby połączyć, albo Odmów, żeby wrócić do aplikacji bez łączenia. Zezwalaj tylko aplikacjom, którym ufasz.

Ponowne łączenie aplikacji. Jeśli aplikacja jest już połączona, ekran otwiera się z zaznaczonymi kontami, które już ma, oraz każdym innym kontem, które nadal można połączyć. To, co zaznaczysz, jest pełną listą: zaznacz nowe konto, żeby je dodać, odznacz konto, żeby odciąć od niego aplikację. Dostęp do kont, które zostają zaznaczone, działa bez przerwy.

Gdy aplikacja ma kilka kont, przy każdym zapytaniu sama wskazuje, którego konta dotyczy — nie musisz nic robić.

Na co pozwala każde uprawnienie

• Widzieć Twoje wydatki: kwoty, daty, kategorie, pozycje i tagi — aplikacja może czytać wydatki połączonego konta, łącznie z pozycjami paragonu oraz późniejszymi zmianami i usunięciami.
• Dodawać, zmieniać i usuwać wydatki — aplikacja może zapisywać w tym koncie. Wydatki dodane przez nią mają na ekranie wydatku dopisek Dodano przez i nazwę aplikacji.
• Pobierać zdjęcia Twoich paragonów — aplikacja może pobrać zdjęcie lub PDF paragonu dołączonego do wydatku.
• Widzieć Twoje kategorie wydatków — aplikacja może czytać listę kategorii, żeby poprawnie przypisywać nowe wydatki.
• Widzieć i dodawać Twoje przychody — aplikacja może czytać przychody połączonego konta, a z uprawnieniem do zapisu dodawać, zmieniać i usuwać przychody. Przychody dodane przez nią mają na ekranie przychodu napis Dodano przez i nazwę aplikacji. Przychody powstałe z przelewu między Twoimi kontami są tylko do odczytu.
• Widzieć i zarządzać Twoimi budżetami — aplikacja może czytać budżety wraz z postępem bieżącego okresu, a z uprawnieniem do zapisu tworzyć je, zmieniać i usuwać.
• Widzieć sumy Twoich przychodów i wydatków — aplikacja może czytać zestawienia: sumy według kategorii i według miesięcy. Dostaje te sumy, a nie pojedyncze wpisy, a kwoty są przeliczone na Twoją walutę wyświetlania.

Każda połączona aplikacja widzi też nazwę, typ i walutę kont, które zaznaczasz, oraz Twoje imię. Nigdy nie dostaje Twojego adresu e-mail i nie widzi żadnego konta, którego nie zaznaczyłeś.

Podgląd i odłączanie aplikacji

Otwórz Ustawienia → Połączone aplikacje. Każda aplikacja to jeden wiersz z kontami, z którymi jest połączona, informacją, kto i kiedy ją połączył, kiedy była ostatnio używana, oraz jej uprawnieniami.

Żeby odciąć jedno konto, dotknij obok niego Usuń konto i potwierdź. Aplikacja od razu traci to konto — jej następne zapytanie o nie zostanie odrzucone — a pozostałe konta działają dalej. Usunięcie ostatniego konta całkowicie odłącza aplikację.

Żeby odciąć całą aplikację, dotknij Odłącz i potwierdź. Traci wtedy dostęp do wszystkich swoich kont naraz. Wydatki, które już dodała, zostają na Twoich kontach. Żeby znów z niej korzystać, połącz ją ponownie z poziomu tej aplikacji.

Za każdym razem, gdy aplikacja zostaje połączona albo dostaje nowe konta, wysyłamy e-mail do osoby, która to zrobiła, z listą dodanych kont. Jeśli taki dostaniesz i nie rozpoznajesz aplikacji, odłącz ją od razu.

Jeśli nie widzisz pozycji Połączone aplikacje w Ustawieniach, łączenie aplikacji nie jest jeszcze dostępne.

Konta współdzielone

Aplikację z kontem może połączyć tylko jego właściciel albo edytor; osoba, która może konto tylko przeglądać, zobaczy je wyszarzone.

Aplikacja połączona z kontem współdzielonym widzi wydatki wszystkich jego członków, a nie tylko osoby, która ją połączyła. Dlatego wszyscy właściciele i edytorzy takiego konta widzą aplikację w Połączonych aplikacjach, razem z informacją, kto ją połączył, i mogą ją z tego konta usunąć.

Z połączenia widzisz zawsze tylko te konta, których sam jesteś właścicielem lub edytorem — nigdy pozostałych kont, które wybrała osoba łącząca aplikację. Gdy dotkniesz Odłącz, aplikacja traci tylko te Twoje konta; dla osoby, która ją skonfigurowała, pozostaje połączona i tylko ona może ją odłączyć całkowicie. Gdy aplikację połączy edytor, e-mail dostają też właściciele połączonych kont — z listą wyłącznie ich własnych kont.

Jeśli osoba, która połączyła aplikację, straci później prawo edycji albo opuści konto, aplikacja przestanie działać dla tego konta; jej pozostałe konta nie są naruszone. Usunięte konto jest automatycznie odpinane od aplikacji.

Konta szyfrowane

• Konta z pełnym szyfrowaniem (zaszyfrowane są też kwoty) nie da się połączyć — aplikacja nie mogłaby w nim niczego odczytać.
• Konto z szyfrowaniem tekstu można połączyć tylko do odczytu: aplikacja widzi kwoty, daty i kategorie, ale opisy, notatki, sprzedawcy, nazwy pozycji, tagi i inne zaszyfrowane teksty pozostają ukryte, a dodawanie i zmienianie wydatków jest zablokowane.

Co obejmuje każdy poziom, opisaliśmy w Szyfrowaniu end-to-end.

Dla deweloperów

Możesz zbudować własną aplikację na API AI Budget — za darmo. Otwórz Ustawienia → Dla deweloperów i dotknij Utwórz aplikację: podaj nazwę, stronę domową i adresy przekierowania (redirect URI), a potem wybierz Aplikacja serwerowa albo Aplikacja mobilna lub przeglądarkowa. Client ID dostajesz od razu; aplikacja serwerowa dostaje też client secret, który wyświetlamy tylko raz — skopiuj go natychmiast.

Pełna dokumentacja API i przewodnik krok po kroku (po angielsku, polsku i rosyjsku) są pod adresem api.ai-budget.pl/public/docs, a także pod linkiem Dokumentacja API na ekranie dla deweloperów. Możesz zarejestrować do 10 aplikacji.