Idempotency in APIs: Safely Repeating the Same Request
Designing API operations that produce no side effects when repeated; idempotency keys and practical implementation at the application layer.
All posts
Tag
#API
REST and modern API design, versioning and consumption.
There are 13 posts with this tag.
Documenting APIs with OpenAPI
Deriving documentation from code and sharing a single source of truth with clients: integrating the OpenAPI specification into your daily development workflow.
Designing APIs the Contract-First Way
How a contract-first approach aligns expectations across teams before a single line of code is written, and what it looks like in practice.
After REST: Trying Out GraphQL
While solving a real over-fetching problem with GraphQL, I weigh where REST is still sufficient and where GraphQL actually makes sense.
API error contract: returning meaningful errors to clients
How binding API error responses to a consistent contract simplifies client development and debugging.
SPA Authentication with Laravel 7 and Sanctum
How Laravel Sanctum solves SPA authentication, and why its cookie-based approach is cleaner than token-based alternatives.
Standardizing API responses: a consistent contract
How returning the same response structure from every endpoint simplifies client code and makes errors predictable.
API versioning strategies and trade-offs
How do you evolve an API without breaking existing clients? A comparison of versioning strategies with their trade-offs, drawn from real-world experience.
Formatting API Responses with Laravel Resource Classes
How to produce clean API responses with Laravel Resource classes without leaking your database model directly to clients.
Speeding Up API Development with Postman
Sharing what I learned about testing API endpoints without a browser, building collections, and integrating Postman into my development workflow.
Pagination, Filtering, and Sorting in REST APIs
How I design pagination, filtering, and sorting parameters in an API to present growing datasets to clients in a manageable way.
Writing JSON API Endpoints with Laravel
A practical walkthrough of building interface-agnostic JSON API endpoints in Laravel.
Fundamentals of RESTful API Design
Practical rules for making an API predictable through the triangle of resources, HTTP methods, and status codes.