🔌 REST API & Tərtibatçı Bələdçisi
AiPBX; CRM sistemləri, ERP proqramları, mobil müştərilər və xarici çağrı mərkəzi panelləri ilə ikitərəfli inteqrasiya qura bilən müasir REST API və WebSocket interfeysləri təqdim edir.
1. Kod Bazası & Arxitektura Standartları
AiPBX veb qatı xarici framework-lərdən asılı olmadan təmiz PHP 8 MVC arxitekturası tətbiq edir:
- Ağ Siyahı Marşrutlaşdırıcısı (Whitelist Router):
index.phpfaylındakı$ROUTESmassivində müəyyən edilməmiş heç bir URL işə salına bilməz. - src/controllers/: Yalnız səlahiyyət yoxlaması, HTTP girişinin doğrulanması və cavabın idarə olunması ilə məşğul olur.
- src/services/: İş qaydalarını (business logic) icra edir, verilənlər bazasına yazır və Asterisk sinxronizasiyasını işə salır.
- src/sync/: Dəyişiklikləri Asterisk
.conffayllarına çevirir və geri qaytarma (rollback) zəmanəti ilə Asterisk-i yenidən yükləyir.
2. REST API Son Nöqtələri (Endpoints)
| Method | Endpoint | Təsvir | Auth |
|---|---|---|---|
| POST | /api/auth/login |
Daxili nömrə ilə kimlik təsdiqi və sessiyaya giriş | Public |
| GET | /api/mobile/contacts.php |
Korporativ daxili nömrə kitabçası və canlı onlayn status | User |
| GET | /api/mobile/history.php |
Zəng tarixçəsi və xalis danışıq müddətləri (CDR) | User |
| POST | /api/cc_actions/agent.php |
Operator fasiləsi (*22/*23) və növbəyə giriş/çıxış nəzarəti | Agent |
3. Avtomatik Test Paketi (PHPUnit CI/CD)
bash — Unit Tests
# Prepare test database
bash bin/setup-test-db.sh
# Execute PHPUnit suite (142 tests, 350 assertions)
./vendor/bin/phpunit