Подключённые приложения и разработчикам

Разрешите другому приложению, которым вы пользуетесь, — например, бухгалтерской программе — работать с вашими расходами в 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 приложений.