اگر تاکنون از Swagger در پروژههای ASP.NET Core خود استفاده نکردهاید، یکی از قدرتمندترین ابزارهای مستندسازی و تست API را نادیده گرفتهاید. تنها با چند خط کد میتوان Swagger را به پروژه اضافه کرد و بهسادگی مستنداتی تعاملی و قابل تست برای APIها در اختیار داشت.
در سایت باگتو، مقالهی «مستندسازی خودکار APIها با Swagger در ASP.NET Core» راهنمایی کامل برای شروع استفاده از این ابزار است. با این حال، پس از نصب Swagger UI، ممکن است ظاهر پیشفرض آن و لوگوی برند Swagger برای برخی شرکتها یا پروژههای رسمی مناسب نباشد. خبر خوب اینجاست: Swagger در ASP.NET Core کاملاً قابل سفارشیسازی است.
در این مقاله قصد داریم روشهای حرفهای و کاربردی برای شخصیسازی ظاهر و رفتار Swagger UI را با شما به اشتراک بگذاریم؛ از تغییر عنوان صفحه گرفته تا افزودن استایل اختصاصی و حذف عناصر پیشفرض برندینگ.