🔌
مستندات API پلتفرم آنیدوطرفه · بیدرنگ · مبتنی بر Gateway
وضعیت: بررسی…
🔁 مدل دوطرفه (چطور کار میکند)
[Inbound] Client → Gateway → Service
POST /api/CrmApi/tickets → Ani.CrmService :8093
POST /api/Convert/transcribe → Ani.ConvertService :8092 → Engine :8077
GET /api/Ai/chat → دستیار هوشمند آنی (پشتیبان سمت سرور)
[Outbound] Service → Platform / Client
POST {callbackUrl} ← نتیجهٔ Job تبدیل
RabbitMQ events ← crm.ticket.created / convert.job.completed
POST /api/CrmApi/callback ← دریافت رویدادهای خارجی
[Realtime] Client ⇄ Service
SignalR /hubs/chat | /hubs/callcontrol | /hubs/radio | /hubs/location
WebRTC (LiveKit) — صدا/تصویر دوطرفه
کلیدهای امنیتی: X-Api-Key برای سرویس↔سرویس، Authorization: Bearer برای کاربر، کلید AI فقط سمت سرور.
🗂️ CRM API — کامل (از طریق پلتفرم)
| متد | مسیر | چه میکند | جهت |
GET | /api/CrmApi/health | سلامت سرویس CRM | IN |
GET | /api/CrmApi/tickets?status=&q= | فهرست تیکتها با فیلتر | IN |
POST | /api/CrmApi/tickets | ایجاد تیکت (SLA خودکار: فوری ۱/بالا ۴/عادی ۲۴ ساعت) | IN |
PATCH | /api/CrmApi/tickets/{id} | تغییر وضعیت/عامل/توضیحات (resolvedAt خودکار) | IN |
GET | /api/CrmApi/leads | سرنخها/فرصتها | IN |
POST | /api/CrmApi/leads | ثبت سرنخ (stage/value) | IN |
PATCH | /api/CrmApi/leads/{id} | جابهجایی مرحله/مبلغ/یادداشت | IN |
GET/POST | /api/CrmApi/contacts | مشتریان (دفترچه) | IN |
GET | /api/CrmApi/stats | آمار: باز/بررسی/بسته/SLA/قیف | IN |
PUT | /api/CrmApi/_sync | همگامسازی انبوه از localStorage | IN |
POST | /api/CrmApi/callback | دریافت وبهوک خارجی | OUT→IN |
🎙️ Convert API (تبدیل دوطرفه)
| متد | مسیر | چه میکند | جهت |
POST | /api/Convert/transcribe | صدا/ویدئو → متن + زمانبندی + SRT | IN |
POST | /api/convert/jobs | Job ناهمگام + callbackUrl | OUT |
GET | /api/convert/jobs/{id} | وضعیت/نتیجهٔ Job | IN |
POST | /api/convert/translate | ترجمهٔ متن/زیرنویس (کوردی/اردو/پشتو/عربی…) | IN |
POST | /api/convert/tts | متن → mp3 (۱۵ صدا) | IN |
POST | /convert/ocr | تصویر/PDF → متن (EasyOCR فارسی/کردی/اردو) | IN |
POST | /api/convert/doc2text /text2doc /text2pptx | Word/PPT/PDF ↔ متن | IN |
🤖 AI و سایر سرویسها
| متد | مسیر | چه میکند |
POST | /api/Ai/chat | دستیار هوشمند آنی (پشتیبان سمت سرور) — ورودی messages/سیستم |
GET | /api/Ai/health | وضعیت AI و کلید پشتیبان (بدون افشای کلید) |
POST | /api/Parking/entry · session/{id}/exit | پارکینگ: ورود/خروج و تعرفه |
POST | /api/ParkingAnpr/detect · ipcamera/detect | تشخیص پلاک + callback |
POST | /api/Rfid/scan | خواندن RFID → ثبت ورود/خروج + ذخیره |
GET | /api/LiveKit/token | توکن اتاق WebRTC (۲۰۴۸ نفر) |
POST | /api/Auth/request-otp | ارسال OTP پیامکی |
POST | /webhook/telegram · /webhook/whatsapp · /webhook/instagram | رباتها: ویس → متن → پاسخ (دوطرفه) |
GET | /api/Health | سلامت کل پلتفرم (DB/RabbitMQ/سرویسها) |
📦 نمونهٔ فراخوانی
// ساخت تیکت (از CRM UI یا ربات)
curl -X POST https://aniii.ir/api/CrmApi/tickets \
-H "Content-Type: application/json" \
-d '{"phone":"9137119313","subject":"مشکل سرویس","priority":"high"}'
// پاسخ
{ "ok":true, "item":{ "id":"t-...", "status":"open",
"dueAt":"2026-10-23T12:30:00", ... } }