cancel
Showing results for 
Search instead for 
Did you mean: 
cancel
421
Views
5
Helpful
6
Replies
Cisco Employee

Swagger Yang to REST API | NSO

I am looking for a use case of documenting API's for a Service model / Yang  by using Swagger. I noticed support of a yanger plugin for generation of swagger based on Yang for the NSO RESTCONF interface. Do we also have a support for REST API ? 

 

Thanks,

 

1 ACCEPTED SOLUTION

Accepted Solutions
Cisco Employee

Re: Swagger Yang to REST API | NSO

I'd argue that the biggest benefit is that it's standardized :) There are also couple of cool features, e.g. notifications (similar to NETCONF notifications).

6 REPLIES 6
Highlighted
Cisco Employee

Re: Swagger Yang to REST API | NSO

Unfortunately not. Any reason you prefer the REST API over the RESTCONF API?

Cisco Employee

Re: Swagger Yang to REST API | NSO

Hi Fredrik,

Thanks for your reply. I am supporting an existing environment to document existing API using swagger. This environment has not adapted to RESTCONF. ;(

PM

Cisco Employee

Re: Swagger Yang to REST API | NSO

I see :) when you make the transition* Swagger is there waiting for you.

 

* Please note that you can mix REST and RESTCONF from the NB system, there is no need for a RESTCONF flag day, but you can change one call at a time from REST to RESTCONF.

Cisco Employee

Re: Swagger Yang to REST API | NSO

Make sense. Thank you sir !!  Just for my understanding, what benefits it can give to NB system or overall operations on the long run? Just want to make sure I collect all points before I make recommendations. 

Cheers,

 

Cisco Employee

Re: Swagger Yang to REST API | NSO

I'd argue that the biggest benefit is that it's standardized :) There are also couple of cool features, e.g. notifications (similar to NETCONF notifications).

Cisco Employee

Re: Swagger Yang to REST API | NSO

Hi Fredrik,

Thanks for your reply. I am supporting an existing environment to document existing API using swagger. This environment has not adapted to RESTCONF