Favourite API Links
List of links I find useful related to APIs
Books
Clean Architecture
- jasontaylordev/Clean Architecture Solution Template
- ardalis/Clean Architecture
- Booknotes on Clean Architecture
- mmacneil/CleanAspNetCoreWebApi
- Tillman32/CleanArchitecture
Design
- Doing APIs right and doing right APIs
- API Design Guide, Best Practices & Good Web API Design Principles
- Techniques For Designing Your API and Microservices
- API Development Guide & Support
- APIs vs. Microservices: Why you need both
- Please. Don't Patch Like That
- Common API mistakes and how to avoid them
- API pagination design
- Microsoft eShopOnWeb ASP.NET Sample
Documentation
- Best Practices For Creating Useful API Documentation
- Minimum Viable Documentation for RESTful APIs
- Swagger in ASP.NET Core: Tips & Tricks
- How To Write Good Software Documentation
- ReDoc
Gateway
- What is an API Gateway?
- Tyk - API and service management platform
- Designing Edge Gateway, Uber’s API Lifecycle Management Platform
Guidelines
- Defining API guidelines for a company: What works?
- Design Guidelines
- Automated Style Guides for REST, GraphQL and gRPC
- How To Build And Enforce Great API Governance
GraphQL
gRPC
OpenAPI
Portal
- API Portal: What to Consider When Designing
- Minimum API Portal
- Minimum viable portal (MVP) template for APIs
REST
- Building a RESTful API with ASP.NET Core 3
- Implementing Advanced RESTful Concerns with ASP.NET Core 3
- How to build a RESTful API — A Deep Dive into REST APIs
- Standards REST
- RESTful API Best Practices and Common Pitfalls
- REST API Design Best Practices for Sub and Nested Resources
- Avoid Data Corruption in Your REST API with ETags
- Handling Concurrent REST Requests and Caching with Etags
Security
- How to securely store API keys
- Steps to building authentication and authorization for RESTful APIs
- The three most common API authentication methods
Serverless
- How do You Structure Your Code When Moving Your API from Express to Serverless Functions?
- Build a RESTful API with the Serverless Framework
- Using Azure Functions Durable HTTP APIs
- Build Serverless APIs with Azure Functions
Testing
Versioning
- ASP.NET API Versioning
- Managing API Versions: The API Lifecycle
- Your API versioning is wrong, which is why I decided to do it 3 different wrong ways
- Modifying APIs - AKA Avoiding Versioning Hell