Wallet REST API

Прямий доступ до ваших фінансових даних

Інтегруйте дані Wallet з Excel, Power BI, власними додатками та інструментами автоматизації за допомогою нашого захищеного REST API.

RESTful
Bearer Token
JSON
Wallet REST API
GET
https://rest.budgetbakers.com/wallet
/v1/api/records
Response:
{
"records": [
{
"id": "a1b2c3d4",
"amount": -42.50,
"recordDate": "2025-10-20",
"category": "Groceries",
"payee": "Whole Foods"
}
]
}

Початок роботи

1

Отримайте Wallet Premium

REST API доступний для підписників Wallet Premium. Оновіть свій обліковий запис, щоб отримати доступ до API.

2

Згенеруйте API токен

Перейдіть до Налаштувань у веб-додатку Wallet та згенеруйте свій персональний API токен. Зберігайте його в безпеці — він надає доступ до ваших даних.

3

Зробіть перший запит

Використовуйте базову URL-адресу та ваш токен, щоб почати запитувати фінансові дані. Дивіться приклад праворуч.

Доступні дані

Отримуйте доступ до всіх фінансових даних через 10 спеціалізованих ендпоінтів.

Основні фінансові дані

GET/v1/api/records

Records

Транзакції з фільтрацією за датою, сумою, категорією

GET/v1/api/accounts

Accounts

Банківські рахунки, кредитні картки, інвестиції

GET/v1/api/categories

Categories

Категорії транзакцій

Планування та цілі

GET/v1/api/budgets

Budgets

Визначення та відстеження бюджетів

GET/v1/api/goals

Goals

Цілі заощаджень та прогрес

GET/v1/api/standing-orders

Standing Orders

Регулярні транзакції та підписки

Організація та інструменти

GET/v1/api/labels

Labels

Мітки та теги транзакцій

GET/v1/api/record-rules

Record Rules

Правила автоматичної категоризації

GET/v1/api/records/by-id

Records by ID

Пошук конкретних транзакцій за ID

Моніторинг

GET/v1/api/api-usage/stats

API Usage Stats

Відстежуйте використання API та залишок квоти

Ключові концепції

Пагінація

Керуйте наборами результатів за допомогою параметрів limit та offset.

  • limit — від 1 до 100 результатів на запит
  • offset — пропустити N результатів
  • nextOffset — повертається у відповіді для зручної пагінації

Фільтрація

Використовуйте типізовані префікси для точної фільтрації даних.

  • eq., contains., contains-i. — текстове порівняння
  • gt., gte., lt., lte. — порівняння діапазонів
  • Комбінуйте кілька фільтрів на будь-якому полі

Ліміти та заголовки

Алгоритм token bucket з чіткими HTTP-заголовками.

  • 500 запитів на годину на токен
  • X-RateLimit-Limit, X-RateLimit-Remaining
  • Заголовок Retry-After при обмеженні

Приклади інтеграції

curl

Найпростіший спосіб протестувати API з терміналу.

curl -X GET "https://rest.budgetbakers.com/wallet/v1/api/records?limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Excel через Power Query

Імпортуйте транзакції безпосередньо в Excel для аналізу та звітів.

  1. 1.Відкрийте Excel → Дані → Отримати дані → З інтернету
  2. 2.Введіть: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Додайте заголовок Authorization з вашим Bearer токеном
  4. 4.Трансформуйте та завантажте дані в таблицю

Power BI Dashboard

Створюйте фінансові дашборди в реальному часі з автоматичним оновленням даних.

  1. 1.Використовуйте Web-конектор у Power BI Desktop
  2. 2.URL: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Налаштуйте автентифікацію Bearer token
  4. 4.Налаштуйте заплановане оновлення та створіть візуалізації

Аналіз на Python

Аналізуйте фінансові дані програмно за допомогою Python.

import requests

headers = {'Authorization': 'Bearer YOUR_TOKEN'}
params = {
    'recordDate': 'gte.2025-01-01',
    'limit': 100
}

response = requests.get(
    'https://rest.budgetbakers.com/wallet/v1/api/records',
    headers=headers,
    params=params
)

data = response.json()
for rec in data['records']:
    print(f"{rec['recordDate']}: {rec['payee']} — {rec['amount']}")

Готові почати?

Ознайомтеся з повною довідкою API з інтерактивною документацією, прикладами запитів та схемами відповідей.