api-design
API Design Basics: Designing for Security
Keep these principles in mind when planning and designing an API, to sidestep major security issues before anyone even starts coding.
Phil Sturgeon
Co-founder of APIs You Won't Hate, and part techie, part woodland creation, and ancient woodland restoration. Co-founder of @ProtectEarthUK. @philsturgeon@mastodon.green
php
Testing HTTP Middleware in Laravel
Learn how to create and test Laravel middleware to enhance API functionality while ensuring stability. Includes examples and tips for best practices
openapi
Learn OpenAPI from these Realistic Examples
If you prefer to learn by looking at examples, maybe a cheeky bit of copy-paste coding, these OpenAPI examples can get you started.
api-design
The "Don't Have Time to Create API Documentation" Paradox
Instead of rushing out a barely planned API and forgetting how it works in the flurry of changes that follow, you can document it before you build to keep everyone on the same page.
openapi
The OpenAPI Discriminator is Redundant & Confusing
A quick look at why OpenAPI's "discriminator" keyword is an outdated concept that you can probably skip worrying about learning.
http
Powerful HTTP/API Clients: Alternatives to Postman
A comparison of quick and easy graphical HTTP clients you can use if you're considering alternatives to Postman.
openapi
Introducing Arazzo: Describe API Workflows with this extension to OpenAPI
A new specification from the OpenAPI Initiative to handle describing workflows, to make more powerful documentation, and functional/end-to-end testing. Sponsored by Bump.sh.
API Design Basics: Resources & Collections
Learn how to use resources and collections for a REST API, getting stuck into some real world examples, using links to get between them all, and some pitfalls to avoid.
openapi
Mocking APIs with Microcks
Learn how to work with a powerful API mocking tool: Microcks, and how to integrate it with your existing API documentation flow.
api-design
API Design Basics: Pagination
How to handle pagination in your REST API, and what are the pros and cons of each method?
openapi
Documenting PHP APIs with OpenAPI
Over on Bump.sh I’ve been writing infinite guides helping people learn how to get OpenAPI out of (or into) their various programming languages and web frameworks, and I wanted to share a summary of that work for the PHP crowd over here with some links.
openapi
How to use JSONPath with OpenAPI
JSONPath is a query language that can be used to extract data from JSON documents, and it's becoming increasingly useful in the OpenAPI ecosystem.