[ 
https://issues.apache.org/jira/browse/SOLR-16880?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17794109#comment-17794109
 ] 

Jan Høydahl commented on SOLR-16880:
------------------------------------

Have you considered adding a SwaggerUI servlet to Solr (e.g. one that serves 
the apiDoc on [http://localhost:8983/api])? It can be unprotected, as it is 
just a web page generated from the OAS.
 !Skjermbilde 2023-12-07 kl. 11.01.57.png|width=800! 

> Make OpenAPI spec a release artifact
> ------------------------------------
>
>                 Key: SOLR-16880
>                 URL: https://issues.apache.org/jira/browse/SOLR-16880
>             Project: Solr
>          Issue Type: Improvement
>          Components: v2 API
>            Reporter: Jason Gerlowski
>            Priority: Major
>         Attachments: Skjermbilde 2023-12-07 kl. 11.01.57.png
>
>
> SOLR-16346 added OpenAPI spec generation to Solr - allowing us to produce a 
> detailed description of our v2 APIs (or at least - those APIs implemented 
> using JAX-RS).
> These spec files have a lot of potential uses - from generating 
> documentation, to API clients, to web UIs.  These have a lot of promise, but 
> it will take the community time to implement and adopt some of them.
> We should make the OpenAPI spec available as a release artifact, so that 
> users can more easily take advantage of it.  Having it published on each 
> release will also allow us to compare specs across versions, as a way to 
> detect backcompat breaks before changes go out the door.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org
For additional commands, e-mail: issues-h...@solr.apache.org

Reply via email to