Managing API Contracts and OpenAPI Paperwork at Scale

Cisco DevNet presents at API Days Paris 2023

12 months after yr, this world occasion for API practitioners will get larger. This yr the occasion was held within the newly renovated CNIT Forest – a central and straightforward to affix location within the Paris La Protection enterprise space. Many people have been amazed by the variety of talks and exhibitors displaying their newest advances in API Design, API Administration, and Occasion Pushed Administration gateways and the various discussions round OpenAPI, JSON-Schema, and GraphQL.

As a sponsor of API Days Paris, Cisco DevNet – Cisco’s developer program – provided a sales space the place we have interaction 100+ conversations with attendees and mentioned easy methods to construct and publish sturdy APIs, sharing our expertise driving API High quality and Safety initiatives. (We additionally had the chance to fulfill and, for a few of us, play chess with Laurent Fressinet, the two-time French Chess Champion, and ‘second assistant’ with opening preparation throughout Magnus Carlsen‘ World Chess Championship matches. However that’s a special story.)

The significance of API Contracts

DevNet provided 2 talks explaining the significance of API Contracts, how we’re evaluating and scoring our APIs internally, and in addition the challenges that include the lifecycle and administration of OpenAPI paperwork (see sources under for recordings and slides).

We have been in a position to present why and the way a profitable API-first technique not solely encourages constant practices when designing, versioning, and documenting APIs, but in addition enables you to look into testing and observing reside site visitors to make sure APIs behave as per their contract.

Schedule a reside Panoptica demo

On this regard, we provided demonstrations of the most recent model of Panoptica – Cisco Cloud Software Safety answer – with a selected give attention to API Safety. If you’re on this matter, we encourage you to schedule a reside demo of Panoptica.

Associated sources

For the various of you who couldn’t attend the convention and wish to additional develop your abilities and experience on this area, we’ve bought you coated:

• Panoptica Studying Lab: This hands-on tutorial will take you all the best way from zero to detecting API drifts from reside site visitors observations.
• Why API Contracts matter: On this discuss we outline what’s an API Contract and the maturity mannequin used at Cisco to judge the standard of API Contracts. We’ll then dive into methods and OpenAPI instruments to mechanically rating APIs.
• Managing OpenAPI Paperwork at scale: On this discuss, we’ll talk about methods for managing OpenAPI paperwork at scale, leveraging classes realized from Cisco’s intensive use of OpenAPI specs throughout its REST API portfolio. We’ll delve into standardization, model management, automation, and modularization. Be part of this session to realize insights into challenges confronted in dealing with very giant paperwork, making certain compliance, and sustaining consistency.
• Panoptica API Safety 

We’re trying ahead to assembly once more subsequent yr for API Days Paris 2024, Dec 3-Fifth 2024. Hope to see you there!

Share: