Facturo logoFacturo

Документация на Public API

За да използвате Public API на Facturo, следвайте тези стъпки: регистрация, създаване на API ключ за избрани фирми и изпращане на заявки с този ключ.

Интерактивна документация (Scalar)

Отворете Scalar за да видите всички endpoints, да тествате заявки и да копирате примери. Въведете API ключа и Company ID в секцията за автентикация в Scalar.

Отвори Scalar – Public API

Как да започнете

  1. 1. Регистрация

    Създайте акаунт в Facturo, ако още нямате. Регистрирайте се от приложението (линк по-долу) и потвърдете имейла си.

    Регистрация в приложението

  2. 2. API ключ за фирми

    Влезте в приложението, отворете Настройки → API ключове и създайте нов API ключ. Изберете за кои фирми да е валиден ключът (можете да имате няколко фирми в един акаунт). Запазете ключа на сигурно място — той се показва само веднъж при създаване.

  3. 3. Правете заявки

    Изпращайте заявки към базовия URL на Public API. Всяка заявка трябва да съдържа заглавка X-Api-Key с вашия API ключ. За повечето endpoints добавете и X-Company-Id с ID на фирмата, в контекста на която искате да работите. Списъкът с фирми за вашия ключ можете да получите с GET /api/v1/api-key/companies.

Автентикация

Всички заявки изискват:

  • X-Api-Key— Заглавка X-Api-Key — вашият API ключ от приложението.
  • X-Company-Id— Заглавка X-Company-Id (или параметър companyId) — ID на фирмата, в контекста на която се изпълнява заявката. За GET /api/v1/api-key/companies не е нужна.

Базов URL на API: https://public-api.facturo.work

Отвори Scalar – Public API