مستندات فنی / API
مستند API ویکی
Base URL توسعه: http://localhost:5088. احراز هویت با کوکی wiki_token است (مستقل از ERP). در Development، Swagger روی /swagger در دسترس است.
| متد | مسیر | Auth | توضیح |
|---|---|---|---|
| GET | /health | عمومی | سلامت سرویس |
| POST | /api/auth/login | عمومی | ورود و ست کردن کوکی wiki_token |
| POST | /api/auth/register | عمومی | ثبت‌نام کاربر جدید |
| POST | /api/auth/logout | عمومی | خروج و پاک کردن کوکی |
| GET | /api/auth/me | کوکی | اطلاعات کاربر و نقش‌ها |
| GET | /api/articles | عمومی | لیست مقالات منتشرشده (q, categoryId, tag, page, size) |
| GET | /api/articles/{slugOrId} | عمومی | جزئیات مقاله (draft فقط با مجوز) |
| GET | /api/categories | عمومی | دسته‌ها |
| GET | /api/tags | عمومی | تگ‌ها |
| GET | /api/courses | عمومی | دوره‌ها با درس‌ها |
| GET | /api/learning-paths | عمومی | مسیرهای یادگیری |
| GET | /api/tech-docs | عمومی | مستندات فنی منتشرشده |
| GET | /api/search | عمومی | جستجوی سراسری q |
| GET | /api/media/{id} | عمومی | سرو فایل رسانه |
| GET | /api/settings | عمومی | تنظیمات عمومی پورتال |
| POST | /api/admin/articles | کوکی | ایجاد مقاله |
| PUT | /api/admin/articles/{id} | کوکی | ویرایش مقاله |
| DELETE | /api/admin/articles/{id} | کوکی | حذف نرم مقاله |
| POST | /api/admin/categories | کوکی | ایجاد/ویرایش دسته |
| POST | /api/admin/tags | کوکی | ایجاد/ویرایش تگ |
| POST | /api/admin/courses | کوکی | ایجاد/ویرایش دوره |
| POST | /api/admin/lessons | کوکی | ایجاد/ویرایش درس |
| POST | /api/admin/learning-paths | کوکی | ایجاد/ویرایش مسیر یادگیری |
| POST | /api/admin/technical-docs | کوکی | ایجاد/ویرایش سند فنی |
| POST | /api/admin/media/upload | کوکی | آپلود فایل (multipart) |
| GET | /api/admin/analytics | کوکی | آمار محتوا و یادگیری |
| POST | /api/admin/settings | کوکی | ذخیره تنظیم کلید/مقدار |
| POST | /api/articles/{slug}/feedback | کوکی | بازخورد مفید/نیاز به بهبود |
| POST | /api/progress/lessons/{lessonId} | کوکی | ثبت تکمیل درس |
این صفحه فقط endpointهای ویکی را پوشش می‌دهد. APIهای ERP در پروژه جدا باقی می‌مانند و در فاز SSO لینک می‌شوند.