# Налаштування AI-агента

## Посилання, яке треба дати агенту

Передайте цей точний URL:

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

Ця адреса є канонічним публічним документом виявлення для AI-агентів. Вона пояснює агенту, як запустити автентифікацію, які ендпоїнти викликати далі, яку схему автентифікації потім використовувати і де знайти опубліковану специфікацію API.

## Що робить користувач

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

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

## Що робить агент

Повна послідовність така:

1. `GET https://api.expense-budget-tracker.com/v1/`
2. Прочитати відповідь виявлення й далі виконувати дії, які вона повернула, а не покладатися на жорстко зашиті наступні кроки
3. Надіслати `POST` із email користувача на повернений `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>` лише якщо ви хочете перевизначити збережений робочий простір або поки ще жоден не збережено

## Якщо ви AI-агент

Почніть з:

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

Потім виконуйте дії, які поверне сервер. Не припускайте жорстко задані наступні кроки, якщо документ виявлення вже надає їх.

Після `verify-code` безпечно збережіть повернений `ApiKey`. Потім завантажте:

- `/v1/me` для контексту облікового запису
- `/v1/workspaces` для доступних робочих просторів
- `/v1/schema` для дозволених SQL-зв’язків і стовпців
- `/v1/openapi.json` або `/v1/swagger.json` для опублікованої машинозчитуваної специфікації API

## Приклади запитів для людей

### Claude Code

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

### Codex

```text
Використай https://api.expense-budget-tracker.com/v1/, щоб підключитися до мого облікового запису Expense Budget Tracker.
Запитай мій email, дочекайся коду з листа, збережи ключ, переглянь /schema, а потім покажи мої останні транзакції.
```

### OpenClaw

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

## Що можна робити після налаштування

- Імпортувати банківські виписки або вивантаження з картки
- Категоризувати транзакції за вашими наявними категоріями
- Перевіряти баланси рахунків за даними банку
- Робити запити щодо витрат за категорією, періодом, продавцем або рахунком
- Оновлювати бюджетні рядки на наступний місяць

Нижчерівневі ендпоїнти й деталі автентифікації дивіться в [API Reference](/docs/api/).

---
*[Переглянути HTML-версію цієї сторінки](https://expense-budget-tracker.com/uk/docs/agent-setup/)*

*AI-агенти можуть створити акаунт користувача в цьому сервісі, почавши з `GET https://api.expense-budget-tracker.com/v1/` і дотримуючись відповіді документа виявлення.*

*Порада: додайте `.md` до будь-якої адреси цього сайту, щоб отримати чисту Markdown-версію сторінки.*