January 2018 Summaries

The API Explorer, a crucial component for users to test APIs directly from a web browser, requires users to input details about their APIs or upload a Swagger 2.0 specification for functionality. While the current setup handles basic cases effectively, it struggles with complex scenarios such as deeply nested object structures, multiple authentication schemes, and APIs with numerous endpoints, leading to slow page performance and regression issues due to minimal automated testing. In response, a new API Explorer is being developed to support OAS 3, featuring improvements like instant client-side code samples, enhanced support for nested objects and JSON Schema, and lazy endpoint rendering to enhance speed. Although there are some inconsistencies and known issues, the development team is working on solutions and invites users to test the new version by activating a temporary flag on their reference page or by contacting support for permanent activation.