singa-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Moaz Reyad (JIRA)" <j...@apache.org>
Subject [jira] [Created] (SINGA-402) Rafiki - adding Swagger support
Date Thu, 08 Nov 2018 16:30:00 GMT
Moaz Reyad created SINGA-402:
--------------------------------

             Summary: Rafiki - adding Swagger support
                 Key: SINGA-402
                 URL: https://issues.apache.org/jira/browse/SINGA-402
             Project: Singa
          Issue Type: Improvement
            Reporter: Moaz Reyad
         Attachments: rafiki.json

[Swagger|http://swagger.io/] is a software tool that helps in design, development, documenting
and testing of RESTful web services.

It is proposed to add Swagger support for Rafiki web API. This will help u
sers and developers
to run the web queries from Swagger UI directly instead of using _curl_ or _python_ commands.
It will also help in documentation and testing.

An example file is provided with this issue to check if this proposal will be useful or not.
The attached file has two working examples from the current Rafiki web API: /tokens and /models.


To run the file:
{code}
$ docker run -p 80:8080 -e SWAGGER_JSON=/rafiki-api/rafiki.json -v /{PATH_TO_RAFIKI.JSON}:/rafiki-api
swaggerapi/swagger-ui
{code}

(Replace / { PATH_TO_RAFIKI.JSON}

with the path to rafiki.json file in your machine)

Start Rafiki and open "localhost" in web browser to show Swagger UI for the API.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Mime
View raw message