🔌 مستندات 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سلامت سرویس CRMIN
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همگام‌سازی انبوه از localStorageIN
POST/api/CrmApi/callbackدریافت وبهوک خارجیOUT→IN

🎙️ Convert API (تبدیل دوطرفه)

متدمسیرچه می‌کندجهت
POST/api/Convert/transcribeصدا/ویدئو → متن + زمان‌بندی + SRTIN
POST/api/convert/jobsJob ناهمگام + callbackUrlOUT
GET/api/convert/jobs/{id}وضعیت/نتیجهٔ JobIN
POST/api/convert/translateترجمهٔ متن/زیرنویس (کوردی/اردو/پشتو/عربی…)IN
POST/api/convert/ttsمتن → mp3 (۱۵ صدا)IN
POST/convert/ocrتصویر/PDF → متن (EasyOCR فارسی/کردی/اردو)IN
POST/api/convert/doc2text /text2doc /text2pptxWord/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", ... } }