امروزه front-end و back-end اجزای یک web application را تشکیل میدهند ولی در مورد سرویس ها API بخش Back-end و کلاینت ها و اجزای دیگری که از API استفاده میکنند بخش front را شامل میشوند.
در این شرایط داشتن داکیومنت و توضیحات فنی دقیق کامل و روان برای API ها یک شرط الزام آور برای استفاده کلاینت ها میباشد تا بتوانند از API آنگونه که باید، استفاده کنند
همچنین توسعه API طی زمان دستخوش تغییراتی میشود که این تغییرات نیاز به داکیومنت و اطلاع رسانی به کلاینت ها نیز دارد و همین امر به دشواری های توسعه API می افزاید
در این مبحث با استفاده از Springfox که استاندارد و تعاریف swagger 2 را پیاده سازی کرده است Spring REST Service را توسعه خواهیم داد و با ویژگی هایی که به سرویس ما اضافه میکند آشنا خواهیم شد