Підключені застосунки та розробникам

Дозвольте іншому застосунку, яким ви користуєтеся, — наприклад, бухгалтерській програмі — працювати з вашими витратами в AI Budget, подивіться, що саме йому дозволено, і відключіть його одним дотиком. Розробники можуть створювати такі застосунки на API AI Budget.

Що означає «підключити застосунок»

Деякі сервіси вміють працювати з вашими даними AI Budget просто на своїх екранах: бухгалтерський застосунок може забирати ваші витрати й чеки або додавати витрати за вас. Щоб це дозволити, ви підключаєте застосунок до одного або кількох своїх рахунків в AI Budget.

Ваш пароль застосунок не бачить ніколи. Коли ви натискаєте в ньому кнопку «Підключити AI Budget», він відкриває сторінку AI Budget: ви входите як зазвичай і бачите:

• назву застосунку, його сайт і хто його зробив;
• Перевірено AI Budget (застосунок, який ми перевірили, наприклад наш власний) або Не перевірено AI Budget;
• список дозволів, яких просить застосунок;
• Які рахунки підключити — біля кожного рахунку є прапорець. Позначте кожен рахунок, яким застосунок може користуватися; кнопка Дозволити неактивна, доки не позначено хоча б один. Якщо підключити можна лише один рахунок, він уже позначений. Рахунки, які ви можете лише переглядати, і рахунки з повним шифруванням неактивні, із зазначенням причини, а рахунок із шифруванням тексту позначено як «лише читання».

Натисніть Дозволити, щоб підключити, або Відхилити, щоб повернутися до застосунку без підключення. Дозволяйте доступ лише застосункам, яким довіряєте.

Повторне підключення. Якщо застосунок уже підключено, екран відкриється з уже позначеними рахунками, які в нього є, і з усіма іншими рахунками, які ще можна підключити. Те, що ви позначите, — це повний список: позначте новий рахунок, щоб додати його, або зніміть позначку, щоб відрізати застосунок від рахунку. Доступ до рахунків, які залишилися позначеними, працює без перерви.

Коли в застосунка кілька рахунків, він сам вказує в кожному запиті, про який рахунок ідеться, — вам нічого робити не потрібно.

Що дає кожен дозвіл

• Бачити ваші витрати: суми, дати, категорії, позиції та теги — застосунок може читати витрати підключеного рахунку, зокрема позиції чека, а також подальші зміни й видалення.
• Додавати, змінювати й видаляти витрати — застосунок може записувати в цей рахунок. На екрані витрати, яку він додав, видно напис Додано через і назву застосунку.
• Завантажувати фото ваших чеків — застосунок може завантажити зображення або PDF чека, прикріпленого до витрати.
• Бачити ваші категорії витрат — застосунок може читати список категорій, щоб правильно розносити нові витрати.
• Бачити й додавати ваші доходи — застосунок може читати доходи підключеного рахунку, а з правом запису — додавати, змінювати й видаляти доходи. Додані ним доходи показують Додано через і назву застосунку. Доходи, створені переказом між вашими рахунками, доступні лише для читання.
• Бачити й вести ваші бюджети — застосунок може читати бюджети разом із прогресом поточного періоду, а з правом запису — створювати, змінювати й видаляти їх.
• Бачити підсумки ваших доходів і витрат — застосунок може читати зведення: підсумки за категоріями й за місяцями. Він отримує ці підсумки, а не окремі записи, а суми перераховуються у вашу валюту відображення.

Будь-який підключений застосунок бачить також назву, тип і валюту рахунків, які ви позначили, та ваше ім’я. Вашої адреси електронної пошти він не отримує ніколи, а рахунків, які ви не позначили, не бачить.

Перегляд і відключення застосунків

Відкрийте Налаштування → Підключені застосунки. Кожен застосунок — один рядок: рахунки, до яких його підключено, хто й коли його підключив, коли ним користувалися востаннє і які в нього дозволи.

Щоб відрізати один рахунок, натисніть поруч із ним Прибрати рахунок і підтвердьте. Застосунок одразу втрачає цей рахунок — його наступний запит щодо нього буде відхилено, — а решта рахунків працює далі. Якщо прибрати останній рахунок, застосунок відключається повністю.

Щоб відключити застосунок цілком, натисніть Відключити й підтвердьте. Він одразу втрачає доступ до всіх своїх рахунків. Витрати, які він устиг додати, лишаються на рахунках. Щоб знову ним користуватися, підключіть його заново із самого застосунку.

Щоразу, коли застосунок підключають або до нього додають рахунки, ми надсилаємо лист тому, хто це зробив, зі списком доданих рахунків. Якщо вам прийшов такий лист, а застосунок вам незнайомий, одразу відключіть його.

Якщо пункту Підключені застосунки в налаштуваннях немає, підключення застосунків поки недоступне.

Спільні рахунки

Підключити застосунок до рахунку може лише його власник або редактор; той, хто може рахунок лише переглядати, побачить його неактивним.

Застосунок, підключений до спільного рахунку, бачить витрати всіх учасників, а не лише того, хто його підключив. Тому всі власники й редактори такого рахунку бачать застосунок у Підключених застосунках, разом із тим, хто його підключив, і можуть прибрати його з цього рахунку.

З підключення ви бачите лише ті рахунки, де самі є власником або редактором, — ніколи решту рахунків, які обрав той, хто підключав. Якщо ви натиснете Відключити, застосунок втратить лише ці ваші рахунки; для того, хто його налаштував, він лишається підключеним, і повністю відключити його може лише він. Коли застосунок підключає редактор, лист отримують і власники підключених рахунків — у ньому перелічено лише їхні власні рахунки.

Якщо той, хто підключив застосунок, згодом стане лише глядачем або покине рахунок, застосунок перестане працювати з цим рахунком; решта його рахунків не зачіпається. Видалений рахунок автоматично відключається від застосунку.

Зашифровані рахунки

• Рахунок із повним шифруванням (зашифровано й суми) підключити не можна — застосунок не зміг би в ньому нічого прочитати.
• Рахунок із шифруванням тексту можна підключити лише для читання: застосунок бачить суми, дати й категорії, але описи, нотатки, продавці, назви позицій, теги та інший зашифрований текст лишаються прихованими, а додавати й змінювати витрати він не може.

Що входить до кожного рівня, описано в розділі Наскрізне шифрування.

Розробникам

Ви можете зробити власний застосунок на API AI Budget — безкоштовно. Відкрийте Налаштування → Розробникам і натисніть Створити застосунок: вкажіть назву, сайт і адреси перенаправлення (redirect URI) та оберіть Серверний застосунок або Мобільний або браузерний застосунок. Client ID ви отримаєте одразу; серверному застосунку видається ще й client secret, який показується лише один раз — скопіюйте його одразу.

Повний довідник API та покрокова інструкція (англійською, польською й російською) — на api.ai-budget.pl/public/docs; туди ж веде посилання Документація API на екрані «Розробникам». Можна зареєструвати до 10 застосунків.