Here are a few examples of API breaking change policies. 1. LinkedIn API Breaking Change Policy 2. Microsoft Graph API Breaking Change Policy 3. HubSpot API Breaking Changes 4. Stripe API Upgrades 5. Twitter Versioning
Stoplight Studio is a great tool for REST API Design, modelling and documentation. I like the fact that it has a mock server built in to enable rapid testing and feedback on API design. Like most of these kind of tools out there in the market right now, it is based on the Open API … Continue reading Stoplight Studio
Here is a list of REST API documentation solutions. Most of these tools are geared towards generating API Reference Docs from REST APIs specifications defined in OAS, RAML or API Blueprint. Most of these tools follow Slate like templates and layouts learned from the Stripe and Twilio Docs to produce their layout. Saves time and … Continue reading REST API Documentation Solutions but what about GraphQL ?