استخدام Postman لتشغيل API

-

يمكن استخدام عدد من التطبيقات توفر مجموعة من الادوات التي تسهل العمل مع API ، من هذه التطبيقات تطبيق Postman 

Postman هي أداة اختبار API تساعد المطورين على التحقق من كيفية عمل API

لتحميل البرنامح من هنا (رابط التحميل)

بعد تحميل المشروع سيكون شكل البرنماج كالتالي : 

انتقل الى Workspaces 

ثم اختر My Workspace

My WorkSpace  تعني مساحة العمل الخاصة. وشكل البرنامح كالتالي : 

ملاحظة : عند العمل مع Localhost يجب ان يكون المشروع بوضع التشغيل ، لذا قم بتشغيل المشروع ثم انتقل الى PostMan 

ضع الرابط التالي بعد اختيار الطريقة Get  ومن انقر فوق Send  

https://localhost:7081/api/Course/GetCoursesById?Id=1

سنقوم الآن باستخدام PostMan لاضافة كورس الى قاعدة البيانات :

سنقوم هنا بإرسال  CoursesModel ك Object  من خلال Body ، كما ذكرنا سابقا ان Parameter يمكن ارسالها من خلال 

[FromBody] ، [FromForm] ، [FromHeader] ، [FromQuery] ، [FromRoute] Attriubtes. 

انتقل الى API    PostCoursesModel ثم اضف الكود التالي:

        [HttpPost]

        [Route("AddCourses")]

        public async Task<ActionResult> PostCoursesModel([FromBody]CoursesModel coursesModel)

        {

            connection = new SqlConnection(configuration.GetConnectionString("STDCS"));

            List<CoursesModel> CoursesModelList = new List<CoursesModel>();

            try

            {

                string sqlQuery = "declare @CourseNumber nvarchar(10)='"+ coursesModel.CourseNumber+ "', @CourseName nvarchar(100)='"+ coursesModel.CourseName+ "', @CourseDescription nvarchar(500)='"+ coursesModel.CourseDescription+ "', @Price money='"+ coursesModel.Price+ "', @Capacity int='"+ coursesModel.Capacity+ "' insert into Courses( CourseNumber, CourseName, CourseDescription, Price, Capacity, CreatedDate) select  @CourseNumber, @CourseName, @CourseDescription, @Price, @Capacity,getdate()";

                DbProviderFactory dbFactory = DbProviderFactories.GetFactory(connection);

                using (var cmd = dbFactory.CreateCommand())

                {

                    cmd.Connection = connection;

                    cmd.CommandType = CommandType.Text;

                    cmd.CommandText = sqlQuery;

                    using (DbDataAdapter adapter = dbFactory.CreateDataAdapter())

                    {

                        adapter.SelectCommand = cmd;

                        await Task.Run(() => adapter.Fill(Dt));

                    }

                }

                

            }

            catch (Exception ex)

            {

                return NotFound();

            }

            finally

            {

            }

            return NoContent();

        }

في هذا الكود استخدمنا ADO.Net لإضافة كورس جديد في قاعدة البيانات حيث استقبلنا Object من نوع CoursesModel 

قم بتشغيل المشروع بالنقر فوق F5 ثم انتقل الى Post Man 

اضف الرابط التالي

  https://localhost:7081/api/Course/AddCourses مع تغيير النوع الى Post 

ثم انتقل الى Body Tab  واختر raw  وحدد الاختيار Json 

ثم اضف Parameters كما هي موضحه

لاحظ الصورة في الأسفل العلامات بالأحمر

انقر فوق Send  سيتم ارسال هذه القيم الى API AddCourses كما في الصورة في الأسفل 

تحقق من قاعدة البيانات ستلاحظ انه تم إضافة كورس جديد