Web API Development for the Absolute Beginner: A Step-by-step Approach to Learning the Fundamentals of Web API Development with .NET 7

ISBN-13: 9781484293478 / Angielski / Miękka / 2023 / 414 str.

Irina Dominte

Opis

Beginning user level

If you are a developer who wants to learn the basic skills of web and application programming interfaces (APIs) with .NET, this book is your complete introduction. The book takes a learn-by-experience approach. You will hit the ground running with a sample project that has everything you need to be wired up.

As you follow along, you will learn simple and intuitive conventions that will free you from some of the more tedious decisions and work, in order to allow you to focus on the business requirements required by your team. Certain components of the framework should always appear in certain folders in the solution to speed up development while others need a name that follows particular conventions. You will learn the building blocks of Web API and how to leverage them to have a well-rounded API. Understanding these small but important tricks will make development faster, easier, and more pleasant, and will prevent time-consuming errors.

Part I introduces you to the basics of Web. Part II gets you started creating an API that you will use and build upon throughout the book until you have a complete project. All companion code is available via GitHub. Part III covers more advanced concepts, including how to override out-of-the-box conventions to customize an API to meet your specific business needs. By the end of the book you will have a fully functional API, and you will be better prepared for an interview for a .NET backend developer job.

What You Will Learn

• Build a start-to-finish Web API
• Know the main concepts of the Web
• Apply best practices in API development to your own projects
• Know the fundamentals of Web API development
• Know the fundamentals of a RESTful API
• Leverage Web API constructs to implement a clean and extensible API
• Get hands-on experience to unit test a Web API
• Gain the skills required to apply for a junior or entry-level .NET Web developer job

Who This Book Is ForDevelopers who want to learn API development with .NET. It is helpful to have some basic C# programming knowledge because it is used in API development in .NET, but it is not mandatory. Readers should be familiar with a programming language to be able to understand code and examples. Experience with web development is not necessary.

Spis treści

Part 1 - API basics 

1. Web API

                    1.1.          What is web api

                    1.2.          When to use Web API

                    1.3.          The world of web applications

                    1.4.          Summary

1.  Introduction to Web

                    2.1.          HTTP Protocol

                    2.2.          Request

                    2.3.          Response

                    2.4.          Headers

                    2.5.          HTTP Verbs

                    2.6.          Summary

1. Setting up the environment

                    3.1.          Installing Visual Studio

                    3.2.          Installing PostMan

                    3.3.          Your first Web Api Project

                    3.4.          Issuing your first request

                    3.5.          Summary

 

1. Web Api - Building blocks

                    4.1.          Convention over Configuration

                    4.2.          Controllers & Actions

                    4.3.          Models vs DTO

                    4.4.          Routing

                    4.5.          Model Binding

                    4.6.          Middlewares

                    4.7.          Dependency Injection

                    4.8.          Summary

 

Part 2 - Implementing an API

1. Getting started

                    5.1.          Your first RESTful API

                    5.2.          What is REST

                    5.3.          Implementing Get

                    5.4.          Implementing POST

                    5.5.          Implementing HEAD

                    5.6.          Implementing PUT

                    5.7.          Implementing DELETE

                    5.8.          Summary

 

1. Introducing an ORM

                    6.1.          Introducing Entity Framework

                    6.2.          Connecting to a database

                    6.3.          Adding migrations

                    6.4.          Summary

1. Getting organized

                    7.1.          Splitting code into layers

                    7.2.          Data Layer, implementing a repository

                    7.3.          Domain Layer

                                   7.3.1.          Extending a domain object

                    7.4.          Services Layer

                    7.5.          Introducing AutoMapper

                    7.6.          Wire everything in the controller

                    7.7.          Summary

 

 

1. Routing

                    8.1.          What is a route

                    8.2.          How to customize routing

                    8.3.          Attribute routing

                    8.4.          Adding two different controllers under the same route

                    8.5.          Route constraints

                    8.6.          Summary

1. Middlewares

                    9.1.          Introducing custom middlewares

                    9.2.          Middleware usage scenarios

                    9.3.          Create your own middleware to add some headers

                    9.4.          Summary

 

Part 3 - Advanced API Topics

1. Model Binding

                 10.1.          Create your own Model Binder

                 10.2.          Register your ModelBinder

                 10.3.          Value Providers

                 10.4.          When to use a value provider

                 10.5.          Model Validation

                 10.6.          Summary

 

1. Versioning The API

                 11.1.          Ways of versioning

                 11.2.          Versioning in URL path

                 11.3.          Versioning in QueryString

                 11.4.          Versioning in Headers

                 11.5.          General rules about versioning

                 11.6.          Deprecating Endpoints

                 11.7.          Summary

1. Documenting The API

                 12.1.          Introducing Open API

                 12.2.          Working with Swashbuckle

 

1. Testing The API

                 13.1.          What is a test

                 13.2.          Writing unit tests

                 13.3.          Writing integrations test

                 13.4.          Summary

O autorze

Irina Dominte is an independent consultant and trainer, international speaker, software architect, Microsoft MVP for Developer Technologies, and a Microsoft Certified Trainer (MCT) with a wealth of experience. Having taught classes, workshops, and presentations for over 2,000 hours, Irina is passionate about coding and keeping abreast of the latest trends and best practices in software architecture and .NET.

Twice a year, for five months, Irina teaches .NET and C# to aspiring software developers, people interested in software development or seeking to expand their knowledge. She is an active member of the community and has founded the DotNet Iasi User Group and the dotnetdays.ro conference, where she connects with like-minded developers who are eager to share their expertise and insights.

Irina is also a prolific blogger, and her website, https://irina.codes, features a wealth of articles on various coding topics. She decided to write this book after learning first-hand how much people struggle to grasp new concepts without proper guidance.

Blurb

If you are a developer who wants to learn the basic skills of web and application programming interfaces (APIs) with .NET, this book is your complete introduction. The book takes a learn-by-experience approach. You will hit the ground running with a sample project that has everything you need to be wired up.

As you follow along, you will learn simple and intuitive conventions that will free you from some of the more tedious decisions and work, in order to allow you to focus on the business requirements required by your team. Certain components of the framework should always appear in certain folders in the solution to speed up development while others need a name that follows particular conventions. You will learn the building blocks of Web API and how to leverage them to have a well-rounded API. Understanding these small but important tricks will make development faster, easier, and more pleasant, and will prevent time-consuming errors.

Part I introduces you to the basics of Web. Part II gets you started creating an API that you will use and build upon throughout the book until you have a complete project. All companion code is available via GitHub. Part III covers more advanced concepts, including how to override out-of-the-box conventions to customize an API to meet your specific business needs. By the end of the book you will have a fully functional API, and you will be better prepared for an interview for a .NET backend developer job.

What You Will Learn

• Build a start-to-finish Web API
• Know the main concepts of the Web
• Apply best practices in API development to your own projects
• Know the fundamentals of Web API development
• Know the fundamentals of a RESTful API
• Leverage Web API constructs to implement a clean and extensible API
• Get hands-on experience to unit test a Web API
• Gain the skills required to apply for a junior or entry-level .NET Web developer job