ВойтиСоздать аккаунт бесплатно

Настройка ИИ-агента

Передайте Claude Code, Codex или OpenClaw одну ссылку обнаружения. Агент прочитает ответ сервера, подтвердит 8-значный код, сохранит выданный долгоживущий ApiKey и начнет работать с вашим рабочим пространством.

Ссылка, которую нужно передать агенту

Передайте агенту точную ссылку:

https://api.expense-budget-tracker.com/v1/

По этому URL доступен основной публичный документ обнаружения для ИИ-агентов. Из него агент узнает, как начать аутентификацию, к каким адресам API обращаться дальше, какую схему аутентификации использовать после входа и где опубликована спецификация API.

Что делает пользователь

  1. Откройте Claude Code, Codex, OpenClaw или другого агента, который умеет выполнять HTTP-запросы.
  2. Попросите агента подключиться к Expense Budget Tracker через https://api.expense-budget-tracker.com/v1/.
  3. Когда агент попросит адрес электронной почты, укажите тот адрес, который вы используете в Expense Budget Tracker.
  4. Проверьте почту и найдите 8-значный код.
  5. Передайте этот код агенту.
  6. Разрешите агенту сохранить полученный ApiKey вне памяти чата, а затем продолжить импорт, запрос данных или работу с бюджетом.

Во время входа не нужно вручную копировать и вставлять ключ. После подтверждения кода из письма агент сам создаст и настроит подключение.

Что делает агент

Полная последовательность выглядит так:

  1. GET https://api.expense-budget-tracker.com/v1/
  2. Прочитать ответ документа обнаружения и следовать описанным в нем действиям, а не жестко задавать следующие шаги
  3. Отправить POST с адресом электронной почты пользователя на возвращенный bootstrapUrl
  4. Получить otpSessionToken и действие verify_code
  5. Запросить у пользователя 8-значный код из письма
  6. Отправить POST с code, otpSessionToken и меткой подключения label на https://auth.expense-budget-tracker.com/api/agent/verify-code
  7. Получить новый ApiKey
  8. Сохранить этот ключ вне памяти чата, желательно как EXPENSE_BUDGET_TRACKER_API_KEY
  9. Выполнить GET https://api.expense-budget-tracker.com/v1/me с заголовком Authorization: ApiKey <key>
  10. Выполнить GET https://api.expense-budget-tracker.com/v1/workspaces
  11. При необходимости создать рабочее пространство через POST /v1/workspaces
  12. Сохранить рабочее пространство по умолчанию через POST /v1/workspaces/{workspaceId}/select
  13. Проверить допустимые таблицы, представления и столбцы через GET https://api.expense-budget-tracker.com/v1/schema
  14. Выполнять SQL через POST https://api.expense-budget-tracker.com/v1/sql

Рабочее пространство выбирается явно, и этот выбор сохраняется. После POST /v1/workspaces/{workspaceId}/select выбранное рабочее пространство закрепляется за этим API-ключом, поэтому в следующих вызовах /v1/sql можно не передавать X-Workspace-Id. При необходимости X-Workspace-Id все равно можно указать, чтобы переопределить сохраненный выбор для конкретного запроса.

Если у пользователя только одно рабочее пространство и для ключа еще не сохранен выбор, сервер автоматически сохранит и будет использовать именно его.

Что должен хранить агент

Ключ, который возвращает verify-code, является долгоживущим. Нельзя полагаться только на память чата.

  • Сохраните его в локальный файл .env как EXPENSE_BUDGET_TRACKER_API_KEY='<PASTE_KEY_HERE>', если пользователь разрешает запись в файлы
  • Иначе экспортируйте его в текущую оболочку как EXPENSE_BUDGET_TRACKER_API_KEY='<PASTE_KEY_HERE>' и попросите пользователя сохранить его в постоянном месте

Для аутентифицированных запросов используйте:

  • Authorization: ApiKey <key>
  • X-Workspace-Id: <workspaceId> только если вы хотите переопределить сохраненное рабочее пространство или оно еще не сохранено

Если вы ИИ-агент

Начните с:

curl https://api.expense-budget-tracker.com/v1/

Затем следуйте действиям, которые вернет сервер. Если документ обнаружения уже задает следующие шаги, не подставляйте свои жестко заданные переходы.

После verify-code безопасно сохраните полученный ApiKey. Затем загрузите:

  • /v1/me для контекста учетной записи
  • /v1/workspaces для списка доступных рабочих пространств
  • /v1/schema для списка допустимых таблиц, представлений и столбцов
  • /v1/openapi.json или /v1/swagger.json для опубликованной машиночитаемой спецификации API

Примеры запросов для человека

Claude Code

Подключись к Expense Budget Tracker через https://api.expense-budget-tracker.com/v1/.
Когда понадобится, используй мой адрес электронной почты, попроси у меня 8-значный код, сохрани полученный ApiKey вне памяти чата, а затем импортируй мою последнюю банковскую выписку из ~/Downloads.

Codex

Подключись к моей учетной записи Expense Budget Tracker через https://api.expense-budget-tracker.com/v1/.
Запроси мой адрес электронной почты, дождись кода из письма, сохрани ключ, проверь `/schema`, а затем покажи мои последние транзакции.

OpenClaw

Подключись к Expense Budget Tracker через https://api.expense-budget-tracker.com/v1/.
После входа покажи список моих рабочих пространств, сохрани одно из них как рабочее пространство по умолчанию для этого ключа и импортируй новый CSV-файл, который я загрузил.

Что можно делать после настройки

  • Импортировать банковские выписки или выгрузки по картам
  • Категоризировать транзакции с использованием ваших существующих категорий
  • Сверять остатки по счетам с данными банка
  • Анализировать расходы по категории, периоду, торговой точке или счету
  • Обновлять бюджетные статьи на следующий месяц

Подробное описание низкоуровневых методов API и схем аутентификации см. в справочнике API.