Web API Development
Design and build APIs other developers can use without asking you questions: clear contracts, honest errors, pagination, versioning and documentation.
Prerequisites
- ASP.NET Core basics: routing, controllers, dependency injection
Technologies
About this course
Building an endpoint that returns data is straightforward. Building an API that a mobile team can consume for two years without confusion is a different skill, and that is what this course is about.
You will design contracts before implementations, separate the shapes you expose from the shapes you store, and settle on one error format that every endpoint honours. These decisions look like overhead on day one and save considerable time by month three.
The course covers the operational side too: paginating large collections, versioning without breaking existing callers, documenting with OpenAPI, and securing endpoints so authorisation is enforced rather than assumed.
Course roadmap
All 18 lessons are written and available.
Module 01
API Foundations
What an API is, and the HTTP vocabulary you need to design one that behaves predictably.
- 01What Is an API?Explain what an API is, who consumes it, and why the contract matters more than the implementation.12 min
- 02HTTP MethodsChoose between GET, POST, PUT, PATCH and DELETE, and respect safety and idempotency.15 min
- 03Status CodesReturn the code that accurately describes what happened.16 min
- 04JSON and SerialisationControl how objects are converted to and from JSON.16 min
- 01REST Principles, Applied PragmaticallyApply REST where it helps and depart from it deliberately where it does not.17 min
- 02Designing Resources and URLsModel endpoints around resources with predictable, stable addresses.16 min
- 03DTOs and Why Not to Expose EntitiesSeparate the shapes you expose from the shapes you store.18 min
- 04Request ValidationReject invalid requests at the boundary with clear, specific messages.17 min
- 05A Consistent Error FormatDefine one error response shape every endpoint honours.16 min
Module 03
Working with Collections
Endpoints that return lists need paging, filtering and sorting before the data grows.
Module 04
Documentation and Change
Make the API understandable, then change it without breaking the people using it.
- 01Authenticating API CallersVerify caller identity with tokens, and validate them correctly.18 min
- 02Authorizing RequestsEnforce what each caller may do, including ownership checks on records.19 min
- 03Testing an APITest endpoints end to end, including authorisation and failure paths.18 min
- 04API PerformanceMeasure latency and remove the common causes of slow endpoints.19 min
On completion
What you should take away
- An API is a contract, and contracts are easier to honour when written down first
- DTOs protect you from having your database schema become your public interface
- Consistent errors and pagination are what make an API pleasant to consume
- Versioning is a planning decision made before the first breaking change, not after
Recommended next course
Entity Framework Core
Work with a database through C# objects while staying aware of the SQL underneath, including the performance traps that catch most teams.
Continue to EF CoreHave a project worth talking through?
Tell us what you're building or what's slowing your current system down. We'll give you a direct read on scope and approach.