ServiceResponse

Intro

This is service response template for .Net 6+ web api projects. This template is based on the best practices and has goal to harmonize all API I/O operations. The benefit of this template over other templates is that it totally integrates with OpenAPI and Swagger. So, IActionResults and other services, response will be visible in Swagger UI and loads of other features are and is going to be included.

This Template is designed by PandaTech LLC. We build software with the greatest quality! Our website: www.pandatech.it :)

---

Example

Model

public class Blog { public int BlogId { get; set; } public string BlogName { get; set; } public string BlogDescription { get; set; } } public class Post { public int PostId { get; set; } public string PostName { get; set; } public string PostDescription { get; set; } public int BlogId { get; set; } }

Interface

public interface IService { public ServiceResponse DeletePost(int postId); public ServiceResponse<Post> GetPost(int postId); public ServiceResponsePaged<List<Blog>> GetAllBlogs(int page, int pageSize); }

Program.cs extract

builder.Services.AddTransient<IService, Services>(); #if DEBUG builder.Services.AddTransient<IExceptionHandler, DebugExceptionHandler>(); #else builder.Services.AddTransient<IExceptionHandler, PublicExceptionHandler>(); #endif

Service

public class Services : IService { public ServiceResponse DeletePost(int postId) { var serviceResponse = new ServiceResponse(); if (postId == 0) // just for example, cannot be in real case { serviceResponse.ResponseStatus = ServiceResponseStatus.NotFound; serviceResponse.Message = $"Post with id {postId} not found"; serviceResponse.Success = false; } else { serviceResponse.Message = $"Post with id {postId} deleted"; serviceResponse.ResponseStatus = ServiceResponseStatus.Ok; } return serviceResponse; } public ServiceResponse<Post> GetPost(int postId) { var serviceResponse = new ServiceResponse<Post>(); serviceResponse.Data = new Post { PostId = postId, PostName = "Your post name", PostDescription = "Post Description", }; return serviceResponse; } public ServiceResponsePaged<List<Blog>> GetAllBlogs(int page, int pageSize) { var serviceResponse = new ServiceResponsePaged<List<Blog>>(); serviceResponse.Page = page; serviceResponse.PageSize = pageSize; serviceResponse.TotalCount = 1; // just for example serviceResponse.Data = new List<Blog> { new Blog { BlogId = 1, BlogName = "Your blog name", BlogDescription = "Blog Description", } }; return serviceResponse; } }