[Apiman-user] ApiMan & Swagger Doc

[Eric Wittmann]

Swagger is currently supported only to document a service.  So it can be 
added by the Service Provider via the Definition tab on the service.  It 
is then displayed on the "Search for a Service to Consume" area of the 
UI (where application developers go to find services they wish to 
consume).  Specifically it will be shown on the service details UI 
screen once an app developer has searched for and found the service.

We do want to use the swagger information in many other places.  One of 
the things we'll be doing shortly is re-implementing the old "Import 
Service(s)" functionality that we had in an early version but didn't 
make the transition from GWT to angularjs.  So importing from a swagger 
definition is a likely candidate.

Additionally, we will want to implement testing tools, where a service 
provider can ensure that the various policies she configured are working 
properly.  For that it will also be useful to have the swagger 
definition available.

-Eric

On 8/6/2015 8:29 AM, Charles Moulliard wrote:
> Hi,
>
> The APiman GUI Web Interface allows to add the Swagger JSON/YAML -
> Service Defintion
> (https://www.dropbox.com/s/rakl089j6ylzwg9/Screenshot%202015-08-06%2013.21.43.png?dl=0).
> Is it used by Apiman or only present for doc purpose ?
>
> Response
>
> [13:23:04] <jcechace>    ch007m, currently the late AFAIK
> [13:23:07] <jcechace>    later *
> [13:34:33] <msavy>    ch007m: presently it'll show you nice API docs
> based upon the swagger doc - however, we're looking at how we might
> evolve that in future
> [13:34:56] <msavy>    e.g. testing the api
>
> Question : Where can I see from the ApiMan the API docs based upon the
> swagger doc ?
>
> Idea : As Swagger API allows to define authorization, that could be
> interesting to import the Swagger Doc of a service in order to generate
> the services.
>
> Regards,
>
> Charles
> _______________________________________________
> Apiman-user mailing list
> Apiman-user at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/apiman-user
>