Аутентификация

Все запросы к API должны содержать Bearer токен в заголовке Authorization. Получите токен в разделе Настройки → API Ключи вашего аккаунта.

# Пример запроса
curl -X GET "https://app.finex.az/api/v1/contacts" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"
            

Base URL

Все запросы отправляются на базовый URL. Все ответы возвращаются в формате JSON.

https://app.finex.az/api/v1

Формат ответа

{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 15,
    "total": 124
  }
}

Коды ошибок

Код	Значение
200	OK — Успешный запрос / Uğurlu sorğu
201	Created — Ресурс создан / Resurs yaradıldı
400	Bad Request — Неверный запрос / Yanlış sorğu
401	Unauthorized — Требуется аутентификация / Autentifikasiya tələb olunur
403	Forbidden — Доступ запрещён / Giriş qadağandır
404	Not Found — Ресурс не найден / Resurs tapılmadı
422	Validation Error — Ошибка валидации / Doğrulama xətası
429	Too Many Requests — Превышен лимит / Limit aşıldı
500	Server Error — Ошибка сервера / Server xətası

Контакты

GET /api/v1/contacts Список контактов

POST /api/v1/contacts Создать контакт

GET /api/v1/contacts/{id} Получить контакт

PUT /api/v1/contacts/{id} Обновить контакт

DELETE /api/v1/contacts/{id} Удалить контакт

Пример создания контакта

POST /api/v1/contacts

{
  "first_name": "Nicat",
  "last_name": "Əliyev",
  "email": "nicat@sirket.az",
  "phone": "+994501234567",
  "company": "TradeCo MMC"
}

// Response 201
{
  "success": true,
  "data": {
    "id": 142,
    "first_name": "Nicat",
    "created_at": "2026-02-23T10:30:00Z"
  }
}

Счета

GET /api/v1/invoices Список счетов

POST /api/v1/invoices Создать счёт

GET /api/v1/invoices/{id} Получить счёт

POST /api/v1/invoices/{id}/send Отправить счёт

POST /api/v1/invoices/{id}/mark-paid Отметить оплаченным

Товары

GET /api/v1/products Список товаров

POST /api/v1/products Создать товар

GET /api/v1/products/{id} Детали товара

PUT /api/v1/products/{id} Обновить товар

GET /api/v1/products/{id}/stock Остатки по складам

Сотрудники

GET /api/v1/employees Список сотрудников

POST /api/v1/employees Добавить сотрудника

GET /api/v1/employees/{id} Профиль сотрудника

GET /api/v1/employees/{id}/payroll История зарплат

Webhooks

Webhooks позволяют получать уведомления об событиях в реальном времени на ваш сервер.

Поддерживаемые события

contact.created

contact.updated

invoice.paid

invoice.overdue

product.low_stock

employee.hired

Пример payload

POST your-webhook-url

{
  "event": "invoice.paid",
  "timestamp": "2026-02-23T10:30:00Z",
  "data": {
    "invoice_id": 1042,
    "amount": 1500.00,
    "currency": "AZN"
  }
}

Получить API Токен

API доступ включён во все платные тарифы Finex ERP. Начните с 3-дневного демо.

Связаться с нами

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

Получить API Токен

Подождите! Специальное предложение

Заказать обратный звонок