API Reference — Dealix v3.0.0
Base URL (prod): https://api.dealix.sa
المصادقة
X-API-Key: <your-key>
عدا مسارات /health*, /docs, /redoc, /openapi.json, /api/v1/webhooks/*.
Health
| Method |
Path |
Description |
| GET |
/health |
Liveness + providers |
| GET |
/live |
Liveness probe |
| GET |
/ready |
Readiness probe |
| GET |
/health/deep |
Deep check (Postgres + Redis + LLM) |
Leads
| Method |
Path |
Description |
| POST |
/api/v1/leads |
Create new lead (10/min) |
| GET |
/api/v1/leads |
List leads |
| GET |
/api/v1/leads/{id} |
Get one |
| PATCH |
/api/v1/leads/{id} |
Update status |
Sales
| Method |
Path |
Description |
| POST |
/api/v1/sales/quote |
Generate proposal (30/min) |
| POST |
/api/v1/sales/book |
Book demo |
| POST |
/api/v1/sales/follow-up |
Trigger follow-up |
Sectors
| Method |
Path |
Description |
| GET |
/api/v1/sectors |
List supported sectors |
| GET |
/api/v1/sectors/{slug}/playbook |
Sector playbook |
Agents
| Method |
Path |
Description |
| POST |
/api/v1/agents/run |
Execute an agent |
| GET |
/api/v1/agents/list |
Available agents |
Webhooks
| Method |
Path |
Verification |
| POST |
/api/v1/webhooks/hubspot |
HMAC-SHA256 (X-HubSpot-Signature-v3) |
| POST |
/api/v1/webhooks/calendly |
HMAC-SHA256 (Calendly-Webhook-Signature) |
| POST |
/api/v1/webhooks/n8n |
HMAC-SHA256 (X-N8N-Signature) |
| POST |
/api/v1/webhooks/whatsapp |
WhatsApp token verify |
Admin
| Method |
Path |
Description |
| GET |
/api/v1/admin/costs?window_hours=24&group_by=model |
Cost aggregation |
| GET |
/api/v1/admin/cache/stats |
Semantic cache hit/miss |
| GET |
/api/v1/admin/audit?limit=200 |
Connector audit log |
Rate Limits
ارجع إلى docs/SECURITY_GUIDE.md.
