Browsing Category
DevSecOps
116 posts
How to Choose the Right HTTP Methods for API Actions: GET, POST, PUT, PATCH, and DELETE Explained
One of the questions I get asked most often by developers new to API design is: “How do…
How to Choose the Right Resource Paths for Your REST API (With Examples)
Choosing resource paths sounds simple until you actually sit down to design a real API. I remember staring…
How to Modify an Existing API Without Breaking Your Users: A Practical Guide
Modifying an API that people already depend on is one of the trickiest parts of my job as…
How to Handle Implementation Influence on API Design: A Complete Guide for Developers
When I first started designing APIs, I made a mistake that almost every beginner makes. I let my…
How to Optimize API Goals: A Complete Guide to Performance, Caching, Versioning, and Long-Term API Health
By the time I’ve identified my functional goals, designed the data, built out parameters, and nailed down success…
How to Design Goal Error Responses: A Complete Guide to Handling Failures the Right Way in APIs
No matter how well I design an API’s success path, things will go wrong — a client will…
How to Design Goal Success Responses: A Practical Guide to API Response Bodies and Status Codes
Once a client sends a valid request and my API successfully performs the action, the next thing I…
How to Design API Data: A Practical Guide to Modeling Resources, Schemas, and Relationships
Once I know what my API needs to do — the functional goals I covered in my previous…
What Do API Designers Do on API Projects? A Complete Breakdown of the Role
“API designer” isn’t always a standalone job title. Sometimes it’s a backend engineer wearing an extra hat, sometimes…
Different Types of API Documentation Explained: Reference, Guides, Tutorials, Error Docs & More
Good documentation is what turns a technically excellent API into one that people actually want to use. You…