API Finance.HDdev
Интегрирайте Finance.HDdev в инструментите си. Достъп до сметки, транзакции, бюджети и категории чрез прост и сигурен REST API.
Удостоверяване
Bearer token (JWT). Получете токена си от личното си пространство в настройките на акаунта.
Базов URL
Всички заявки използват следния базов URL:
https://finance.hddev.eu/api/v1Формат
Всички заявки и отговори използват JSON формат. Задължителен хедър: Content-Type: application/json
Пример за удостоверяване
curl -X GET https://finance.hddev.eu/api/v1/accounts \ -H "Authorization: Bearer VOTRE_TOKEN_JWT" \ -H "Content-Type: application/json"
Налични endpoints
Преглед на основните endpoints на Finance.HDdev API.
/api/v1/accountsСписък на свързаните банкови сметки с баланси и метаданни.
/api/v1/transactionsСписък на транзакциите с филтри (дата, категория, сума, сметка).
/api/v1/budgetsБюджети и цели с текущ напредък.
/api/v1/transactionsСъздаване на ръчна транзакция (разход, приход или превод).
/api/v1/categoriesНалични категории (системни и персонализирани).
Лимити на заявките
API заявките са ограничени за гарантиране стабилността на услугата.
Пълна документация
Пълната интерактивна документация (OpenAPI / Swagger) ще бъде скоро налична. Тя ще включва схеми на заявки и отговори, кодове за грешки и подробни примери.
Сигурност
Всички комуникации са криптирани чрез HTTPS/TLS. JWT токените изтичат след 30 минути (автоматично подновяване чрез refresh token). API е в съответствие с GDPR и никога не връща банкови данни за вход.
Нуждаете се от помощ с API?
Нашият технически екип е на разположение, за да ви помогне с интегрирането на Finance.HDdev API.
Свържете се с API екипаapi@hddev.eu
Принципи на архитектурата и използване
API на Finance.HDdev е базиран на RESTful архитектура, което го прави предвидим и лесен за използване. Всички заявки се извършват чрез HTTPS за гарантиране на поверителността. Отговорите и телата на POST/PUT заявките са систематично форматирани в JSON. Структурата на URL адресите е ориентирана към ресурси. Прилагаме система за ограничаване на заявките за стабилност на платформата.
Ключови Endpoints и случаи на употреба
Нашият API предлага endpoints за всички функции за финансово управление. Endpoint `/transactions` позволява изброяване, филтриране и извличане на детайли за всяка транзакция. С `/accounts` получавате списъка на свързаните си сметки. За бюджетно проследяване endpoints `/budgets` и `/categories` дават пълен контрол. Endpoint `/goals` позволява управление на целите за спестяване.
Удостоверяване и сигурност на API
Сигурността е наш приоритет. Достъпът до API е защитен с лични ключове за удостоверяване. Всяка API заявка трябва да включва API ключа ви в хедъра Authorization като Bearer Token. Задължително е да пазите тези ключове в тайна. Всички API връзки са криптирани с TLS. Насърчаваме използването на webhooks за известия в реално време.