Ana Səhifə› API Dokumentasiya
REST API v1

API Dokumentasiyası

Finex ERP-ni öz sistemlərinizlə REST API vasitəsilə inteqrasiya edin. JSON formatı, Bearer autentifikasiya.

✓ REST API ✓ JSON Format ✓ Bearer Auth ✓ Rate Limiting
Autentifikasiya

Bütün API sorğuları Authorization başlığında Bearer tokeni ehtiva etməlidir. Tokeni hesabınızın Parametrlər → API Açarları bölməsindən alın.

# Nümunə sorğu 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

Bütün sorğular əsas URL-ə göndərilir. Bütün cavablar JSON formatında qaytarılır.

https://app.finex.az/api/v1
Cavab formatı
{ "success": true, "data": { ... }, "meta": { "page": 1, "per_page": 15, "total": 124 } }
Xəta Kodları
KodMəna
200OK — Успешный запрос / Uğurlu sorğu
201Created — Ресурс создан / Resurs yaradıldı
400Bad Request — Неверный запрос / Yanlış sorğu
401Unauthorized — Требуется аутентификация / Autentifikasiya tələb olunur
403Forbidden — Доступ запрещён / Giriş qadağandır
404Not Found — Ресурс не найден / Resurs tapılmadı
422Validation Error — Ошибка валидации / Doğrulama xətası
429Too Many Requests — Превышен лимит / Limit aşıldı
500Server Error — Ошибка сервера / Server xətası
Kontaktlar
GET /api/v1/contacts Kontaktlar siyahısı
POST /api/v1/contacts Kontakt yarat
GET /api/v1/contacts/{id} Kontakt əldə et
PUT /api/v1/contacts/{id} Kontaktı yenilə
DELETE /api/v1/contacts/{id} Kontaktı sil
Kontakt yaratma nümunəsi
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" } }
Fakturalar
GET /api/v1/invoices Fakturalar siyahısı
POST /api/v1/invoices Faktura yarat
GET /api/v1/invoices/{id} Faktura əldə et
POST /api/v1/invoices/{id}/send Faktura göndər
POST /api/v1/invoices/{id}/mark-paid Ödənilmiş kimi işarələ
Məhsullar
GET /api/v1/products Məhsullar siyahısı
POST /api/v1/products Məhsul yarat
GET /api/v1/products/{id} Məhsul detalları
PUT /api/v1/products/{id} Məhsulu yenilə
GET /api/v1/products/{id}/stock Anbar qalıqları
İşçilər
GET /api/v1/employees İşçilər siyahısı
POST /api/v1/employees İşçi əlavə et
GET /api/v1/employees/{id} İşçi profili
GET /api/v1/employees/{id}/payroll Əmək haqqı tarixi
Webhooks

Webhooks real vaxtda serveriinizə hadisə bildirişləri almağa imkan verir.

Dəstəklənən hadisələr
contact.created
contact.updated
invoice.paid
invoice.overdue
product.low_stock
employee.hired
Payload nümunəsi
POST webhook-urliniz { "event": "invoice.paid", "timestamp": "2026-02-23T10:30:00Z", "data": { "invoice_id": 1042, "amount": 1500.00, "currency": "AZN" } }

API Token Al

API girişi Finex ERP-nin bütün ödənişli tarif planlarına daxildir. 3 günlük demo ilə başlayın.

Bizimlə Əlaqə

🍪 Saytı yaxşılaşdırmaq üçün cookie istifadə edirik. Davam etməklə siz Gizlilik Siyasətimizə razılaşırsınız.