🔌 REST-API & Entwickler-Referenz
AiPBX stellt strukturierte REST-Endpunkte und WebSocket-Protokolle für die bidirektionale Anbindung an CRMs, ERP-Systeme, Callcenter-Wallboards und Mobil-Softphones bereit.
1. Codebasis- & Architekturstandards
Der AiPBX-Webkern basiert auf einem sauberen, schlanken PHP 8 MVC-Muster:
- Whitelist-Front-Router: Nur in
index.php($ROUTES) definierte Pfade sind erreichbar; alle anderen erzeugen 404. - src/controllers/: Zugriffskontrolle, Eingabeprüfung und Orchestrierung.
- src/services/: Geschäftslogik, Datenbankoperationen und Asterisk-Synchronisation.
- src/sync/: Erzeugt modulare Asterisk-Konfigurationsdateien mit automatischer
.bak-Rollback-Sicherheit.
2. REST-API-Endpunkte
| Method | Endpoint | Beschreibung | Auth |
|---|---|---|---|
| POST | /api/auth/login |
Authentifizierung & Session-Start | Public |
| GET | /api/mobile/contacts.php |
Unternehmensverzeichnis mit Live-Präsenz | User |
| GET | /api/mobile/history.php |
Anrufhistorie und Gesprächsdauern (CDR) | User |
| POST | /api/cc_actions/agent.php |
Agenten-Pause (*22/*23) und Warteschlangen-Status | Agent |
3. Automatisierte Test-Suite (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