alihan/fn-serverless
1
0
Fork 0
mirror of https://github.com/fnproject/fn.git synced 2022-10-28 21:29:17 +03:00
Code Issues Packages Projects Releases Wiki Activity

Improvements on API error, swagger and status code (#428)

Browse Source 
* improvements on API error, swagger and status code

* missing validation

* removing typo

* fix if-within-if

* fix handle app delete
This commit is contained in:
Pedro Nasser
2016-12-13 19:18:52 -02:00
committed by GitHub
parent 34d6c6e101
commit 32de7d5361
13 changed files with 103 additions and 88 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
api/server/apps_create.go
View File

@@ -36,24 +36,28 @@ func (s *Server) handleAppCreate(c *gin.Context) {
err = s.FireBeforeAppCreate(ctx, wapp.App) err = s.FireBeforeAppCreate(ctx, wapp.App)
if err != nil { if err != nil {
log.WithError(err).Errorln(models.ErrAppsCreate) log.WithError(err).Error(models.ErrAppsCreate)
c.JSON(http.StatusInternalServerError, simpleError(err)) c.JSON(http.StatusInternalServerError, simpleError(err))
return return
} }
app, err := s.Datastore.InsertApp(ctx, wapp.App) app, err := s.Datastore.InsertApp(ctx, wapp.App)
if err != nil { if err == models.ErrAppsAlreadyExists {
log.WithError(err).Errorln(models.ErrAppsCreate) log.WithError(err).Debug(models.ErrAppsCreate)
c.JSON(http.StatusInternalServerError, simpleError(err)) c.JSON(http.StatusConflict, simpleError(err))
return
} else if err != nil {
log.WithError(err).Error(models.ErrAppsCreate)
c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
err = s.FireAfterAppCreate(ctx, wapp.App) err = s.FireAfterAppCreate(ctx, wapp.App)
if err != nil { if err != nil {
log.WithError(err).Errorln(models.ErrAppsCreate) log.WithError(err).Error(models.ErrAppsCreate)
c.JSON(http.StatusInternalServerError, simpleError(err)) c.JSON(http.StatusInternalServerError, simpleError(err))
return return
} }
c.JSON(http.StatusCreated, appResponse{"App successfully created", app}) c.JSON(http.StatusOK, appResponse{"App successfully created", app})
} }

25
api/server/apps_delete.go
View File

@@ -17,8 +17,8 @@ func (s *Server) handleAppDelete(c *gin.Context) {
routes, err := s.Datastore.GetRoutesByApp(ctx, app.Name, &models.RouteFilter{}) routes, err := s.Datastore.GetRoutesByApp(ctx, app.Name, &models.RouteFilter{})
if err != nil { if err != nil {
log.WithError(err).Debug(models.ErrAppsRemoving) log.WithError(err).Error(models.ErrAppsRemoving)
c.JSON(http.StatusInternalServerError, simpleError(models.ErrAppsRemoving)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
@@ -30,25 +30,26 @@ func (s *Server) handleAppDelete(c *gin.Context) {
err = s.FireBeforeAppDelete(ctx, app) err = s.FireBeforeAppDelete(ctx, app)
if err != nil { if err != nil {
log.WithError(err).Errorln(models.ErrAppsRemoving) log.WithError(err).Error(models.ErrAppsRemoving)
c.JSON(http.StatusInternalServerError, simpleError(err)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
if err = s.Datastore.RemoveApp(ctx, app.Name); err != nil { err = s.Datastore.RemoveApp(ctx, app.Name)
log.WithError(err).Debug(models.ErrAppsRemoving)
if err == models.ErrAppsNotFound { if err == models.ErrAppsNotFound {
c.JSON(http.StatusNotFound, simpleError(models.ErrAppsNotFound)) log.WithError(err).Debug(models.ErrAppsRemoving)
} else { c.JSON(http.StatusNotFound, simpleError(err))
c.JSON(http.StatusInternalServerError, simpleError(models.ErrAppsRemoving)) return
} } else if err != nil {
log.WithError(err).Error(models.ErrAppsRemoving)
c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
err = s.FireAfterAppDelete(ctx, app) err = s.FireAfterAppDelete(ctx, app)
if err != nil { if err != nil {
log.WithError(err).Errorln(models.ErrAppsRemoving) log.WithError(err).Error(models.ErrAppsRemoving)
c.JSON(http.StatusInternalServerError, simpleError(err)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }

4
api/server/apps_list.go
View File

@@ -17,8 +17,8 @@ func (s *Server) handleAppList(c *gin.Context) {
apps, err := s.Datastore.GetApps(ctx, filter) apps, err := s.Datastore.GetApps(ctx, filter)
if err != nil { if err != nil {
log.WithError(err).Debug(models.ErrAppsList) log.WithError(err).Error(models.ErrAppsList)
c.JSON(http.StatusInternalServerError, simpleError(models.ErrAppsList)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }

4
api/server/apps_test.go
View File

@@ -55,7 +55,7 @@ func TestAppCreate(t *testing.T) {
{&datastore.Mock{}, "/v1/apps", `{ "app": { "name": "&&%@!#$#@$" } }`, http.StatusInternalServerError, models.ErrAppsValidationInvalidName}, {&datastore.Mock{}, "/v1/apps", `{ "app": { "name": "&&%@!#$#@$" } }`, http.StatusInternalServerError, models.ErrAppsValidationInvalidName},
// success // success
{&datastore.Mock{}, "/v1/apps", `{ "app": { "name": "teste" } }`, http.StatusCreated, nil}, {&datastore.Mock{}, "/v1/apps", `{ "app": { "name": "teste" } }`, http.StatusOK, nil},
} { } {
rnr, cancel := testRunner(t) rnr, cancel := testRunner(t)
router := testRouter(test.mock, &mqs.Mock{}, rnr, tasks) router := testRouter(test.mock, &mqs.Mock{}, rnr, tasks)
@@ -226,7 +226,7 @@ func TestAppUpdate(t *testing.T) {
Apps: []*models.App{{ Apps: []*models.App{{
Name: "myapp", Name: "myapp",
}}, }},
}, "/v1/apps/myapp", `{ "app": { "name": "othername" } }`, http.StatusForbidden, nil}, }, "/v1/apps/myapp", `{ "app": { "name": "othername" } }`, http.StatusBadRequest, nil},
} { } {
rnr, cancel := testRunner(t) rnr, cancel := testRunner(t)
router := testRouter(test.mock, &mqs.Mock{}, rnr, tasks) router := testRouter(test.mock, &mqs.Mock{}, rnr, tasks)

19
api/server/apps_update.go
View File

@@ -30,7 +30,7 @@ func (s *Server) handleAppUpdate(c *gin.Context) {
if wapp.App.Name != "" { if wapp.App.Name != "" {
log.Debug(models.ErrAppsNameImmutable) log.Debug(models.ErrAppsNameImmutable)
c.JSON(http.StatusForbidden, simpleError(models.ErrAppsNameImmutable)) c.JSON(http.StatusBadRequest, simpleError(models.ErrAppsNameImmutable))
return return
} }
@@ -38,25 +38,28 @@ func (s *Server) handleAppUpdate(c *gin.Context) {
err = s.FireAfterAppUpdate(ctx, wapp.App) err = s.FireAfterAppUpdate(ctx, wapp.App)
if err != nil { if err != nil {
log.WithError(err).Errorln(models.ErrAppsUpdate) log.WithError(err).Error(models.ErrAppsUpdate)
c.JSON(http.StatusInternalServerError, simpleError(err)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
app, err := s.Datastore.UpdateApp(ctx, wapp.App) app, err := s.Datastore.UpdateApp(ctx, wapp.App)
if err != nil { if err == models.ErrAppsNotFound {
log.WithError(err).Debug(models.ErrAppsUpdate) log.WithError(err).Debug(models.ErrAppsUpdate)
c.JSON(http.StatusInternalServerError, simpleError(models.ErrAppsUpdate)) c.JSON(http.StatusNotFound, simpleError(err))
return
} else if err != nil {
log.WithError(err).Error(models.ErrAppsUpdate)
c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
err = s.FireAfterAppUpdate(ctx, wapp.App) err = s.FireAfterAppUpdate(ctx, wapp.App)
if err != nil { if err != nil {
log.WithError(err).Errorln(models.ErrAppsUpdate) log.WithError(err).Error(models.ErrAppsUpdate)
c.JSON(http.StatusInternalServerError, simpleError(err)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
// Nothing to update right now in apps
c.JSON(http.StatusOK, appResponse{"App successfully updated", app}) c.JSON(http.StatusOK, appResponse{"App successfully updated", app})
} }

34
api/server/routes_create.go
View File

@@ -18,13 +18,13 @@ func (s *Server) handleRouteCreate(c *gin.Context) {
err := c.BindJSON(&wroute) err := c.BindJSON(&wroute)
if err != nil { if err != nil {
log.WithError(err).Error(models.ErrInvalidJSON) log.WithError(err).Debug(models.ErrInvalidJSON)
c.JSON(http.StatusBadRequest, simpleError(models.ErrInvalidJSON)) c.JSON(http.StatusBadRequest, simpleError(models.ErrInvalidJSON))
return return
} }
if wroute.Route == nil { if wroute.Route == nil {
log.WithError(err).Error(models.ErrInvalidJSON) log.WithError(err).Debug(models.ErrInvalidJSON)
c.JSON(http.StatusBadRequest, simpleError(models.ErrRoutesMissingNew)) c.JSON(http.StatusBadRequest, simpleError(models.ErrRoutesMissingNew))
return return
} }
@@ -32,20 +32,22 @@ func (s *Server) handleRouteCreate(c *gin.Context) {
wroute.Route.AppName = ctx.Value("appName").(string) wroute.Route.AppName = ctx.Value("appName").(string)
if err := wroute.Validate(); err != nil { if err := wroute.Validate(); err != nil {
log.Error(err) log.WithError(err).Debug(models.ErrRoutesCreate)
c.JSON(http.StatusInternalServerError, simpleError(err)) c.JSON(http.StatusBadRequest, simpleError(err))
return return
} }
if wroute.Route.Image == "" { if wroute.Route.Image == "" {
log.WithError(models.ErrRoutesValidationMissingImage).Debug(models.ErrRoutesCreate)
c.JSON(http.StatusBadRequest, simpleError(models.ErrRoutesValidationMissingImage)) c.JSON(http.StatusBadRequest, simpleError(models.ErrRoutesValidationMissingImage))
return return
} }
err = s.Runner.EnsureImageExists(ctx, &task.Config{ err = s.Runner.EnsureImageExists(ctx, &task.Config{
Image: wroute.Route.Image, Image: wroute.Route.Image,
}) })
if err != nil { if err != nil {
c.JSON(http.StatusInternalServerError, simpleError(models.ErrUsableImage)) c.JSON(http.StatusBadRequest, simpleError(models.ErrUsableImage))
return return
} }
@@ -65,33 +67,37 @@ func (s *Server) handleRouteCreate(c *gin.Context) {
err = s.FireBeforeAppCreate(ctx, newapp) err = s.FireBeforeAppCreate(ctx, newapp)
if err != nil { if err != nil {
log.WithError(err).Errorln(models.ErrAppsCreate) log.WithError(err).Error(models.ErrAppsCreate)
c.JSON(http.StatusInternalServerError, simpleError(err)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
_, err = s.Datastore.InsertApp(ctx, newapp) _, err = s.Datastore.InsertApp(ctx, newapp)
if err != nil { if err != nil {
log.WithError(err).Error(models.ErrAppsCreate) log.WithError(err).Error(models.ErrRoutesCreate)
c.JSON(http.StatusInternalServerError, simpleError(models.ErrAppsCreate)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
err = s.FireAfterAppCreate(ctx, newapp) err = s.FireAfterAppCreate(ctx, newapp)
if err != nil { if err != nil {
log.WithError(err).Errorln(models.ErrAppsCreate) log.WithError(err).Error(models.ErrRoutesCreate)
c.JSON(http.StatusInternalServerError, simpleError(err)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
} }
route, err := s.Datastore.InsertRoute(ctx, wroute.Route) route, err := s.Datastore.InsertRoute(ctx, wroute.Route)
if err != nil { if err == models.ErrRoutesAlreadyExists {
log.WithError(err).Debug(models.ErrRoutesCreate)
c.JSON(http.StatusConflict, simpleError(models.ErrRoutesAlreadyExists))
return
} else if err != nil {
log.WithError(err).Error(models.ErrRoutesCreate) log.WithError(err).Error(models.ErrRoutesCreate)
c.JSON(http.StatusInternalServerError, simpleError(models.ErrRoutesCreate)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
c.JSON(http.StatusCreated, routeResponse{"Route successfully created", route}) c.JSON(http.StatusOK, routeResponse{"Route successfully created", route})
} }

10
api/server/routes_delete.go
View File

@@ -17,18 +17,12 @@ func (s *Server) handleRouteDelete(c *gin.Context) {
appName := ctx.Value("appName").(string) appName := ctx.Value("appName").(string)
routePath := path.Clean(ctx.Value("routePath").(string)) routePath := path.Clean(ctx.Value("routePath").(string))
route, err := s.Datastore.GetRoute(ctx, appName, routePath)
if err != nil || route == nil {
log.Error(models.ErrRoutesNotFound)
c.JSON(http.StatusNotFound, simpleError(models.ErrRoutesNotFound))
return
}
if err := s.Datastore.RemoveRoute(ctx, appName, routePath); err != nil { if err := s.Datastore.RemoveRoute(ctx, appName, routePath); err != nil {
log.WithError(err).Debug(models.ErrRoutesRemoving)
if err == models.ErrRoutesNotFound { if err == models.ErrRoutesNotFound {
log.WithError(err).Debug(models.ErrRoutesRemoving)
c.JSON(http.StatusNotFound, simpleError(models.ErrRoutesNotFound)) c.JSON(http.StatusNotFound, simpleError(models.ErrRoutesNotFound))
} else { } else {
log.WithError(err).Error(models.ErrRoutesRemoving)
c.JSON(http.StatusInternalServerError, simpleError(models.ErrRoutesRemoving)) c.JSON(http.StatusInternalServerError, simpleError(models.ErrRoutesRemoving))
} }
return return

7
api/server/routes_get.go
View File

@@ -5,7 +5,6 @@ import (
"net/http" "net/http"
"path" "path"
"github.com/Sirupsen/logrus"
"github.com/gin-gonic/gin" "github.com/gin-gonic/gin"
"github.com/iron-io/functions/api/models" "github.com/iron-io/functions/api/models"
"github.com/iron-io/runner/common" "github.com/iron-io/runner/common"
@@ -20,16 +19,14 @@ func (s *Server) handleRouteGet(c *gin.Context) {
route, err := s.Datastore.GetRoute(ctx, appName, routePath) route, err := s.Datastore.GetRoute(ctx, appName, routePath)
if err != nil && err != models.ErrRoutesNotFound { if err != nil && err != models.ErrRoutesNotFound {
log.WithError(err).Error(models.ErrRoutesGet) log.WithError(err).Error(models.ErrRoutesGet)
c.JSON(http.StatusInternalServerError, simpleError(models.ErrRoutesGet)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} else if route == nil { } else if route == nil {
log.Debug(models.ErrRoutesNotFound)
c.JSON(http.StatusNotFound, simpleError(models.ErrRoutesNotFound)) c.JSON(http.StatusNotFound, simpleError(models.ErrRoutesNotFound))
return return
} }
log.WithFields(logrus.Fields{"route": route}).Debug("Got route")
c.JSON(http.StatusOK, routeResponse{"Successfully loaded route", route}) c.JSON(http.StatusOK, routeResponse{"Successfully loaded route", route})
} }

11
api/server/routes_list.go
View File

@@ -4,7 +4,6 @@ import (
"context" "context"
"net/http" "net/http"
"github.com/Sirupsen/logrus"
"github.com/gin-gonic/gin" "github.com/gin-gonic/gin"
"github.com/iron-io/functions/api/models" "github.com/iron-io/functions/api/models"
"github.com/iron-io/runner/common" "github.com/iron-io/runner/common"
@@ -28,13 +27,15 @@ func (s *Server) handleRouteList(c *gin.Context) {
routes, err = s.Datastore.GetRoutes(ctx, filter) routes, err = s.Datastore.GetRoutes(ctx, filter)
} }
if err != nil { if err == models.ErrAppsNotFound {
log.WithError(err).Debug(models.ErrRoutesGet)
c.JSON(http.StatusNotFound, simpleError(err))
return
} else if err != nil {
log.WithError(err).Error(models.ErrRoutesGet) log.WithError(err).Error(models.ErrRoutesGet)
c.JSON(http.StatusInternalServerError, simpleError(models.ErrRoutesGet)) c.JSON(http.StatusInternalServerError, simpleError(ErrInternalServerError))
return return
} }
log.WithFields(logrus.Fields{"routes": routes}).Debug("Got routes")
c.JSON(http.StatusOK, routesResponse{"Sucessfully listed routes", routes}) c.JSON(http.StatusOK, routesResponse{"Sucessfully listed routes", routes})
} }

10
api/server/routes_test.go
View File

@@ -27,14 +27,14 @@ func TestRouteCreate(t *testing.T) {
{&datastore.Mock{}, "/v1/apps/a/routes", ``, http.StatusBadRequest, models.ErrInvalidJSON}, {&datastore.Mock{}, "/v1/apps/a/routes", ``, http.StatusBadRequest, models.ErrInvalidJSON},
{&datastore.Mock{}, "/v1/apps/a/routes", `{ }`, http.StatusBadRequest, models.ErrRoutesMissingNew}, {&datastore.Mock{}, "/v1/apps/a/routes", `{ }`, http.StatusBadRequest, models.ErrRoutesMissingNew},
{&datastore.Mock{}, "/v1/apps/a/routes", `{ "path": "/myroute" }`, http.StatusBadRequest, models.ErrRoutesMissingNew}, {&datastore.Mock{}, "/v1/apps/a/routes", `{ "path": "/myroute" }`, http.StatusBadRequest, models.ErrRoutesMissingNew},
{&datastore.Mock{}, "/v1/apps/a/routes", `{ "route": { } }`, http.StatusInternalServerError, models.ErrRoutesValidationMissingPath}, {&datastore.Mock{}, "/v1/apps/a/routes", `{ "route": { } }`, http.StatusBadRequest, models.ErrRoutesValidationMissingPath},
{&datastore.Mock{}, "/v1/apps/a/routes", `{ "route": { "path": "/myroute" } }`, http.StatusBadRequest, models.ErrRoutesValidationMissingImage}, {&datastore.Mock{}, "/v1/apps/a/routes", `{ "route": { "path": "/myroute" } }`, http.StatusBadRequest, models.ErrRoutesValidationMissingImage},
{&datastore.Mock{}, "/v1/apps/a/routes", `{ "route": { "image": "iron/hello" } }`, http.StatusInternalServerError, models.ErrRoutesValidationMissingPath}, {&datastore.Mock{}, "/v1/apps/a/routes", `{ "route": { "image": "iron/hello" } }`, http.StatusBadRequest, models.ErrRoutesValidationMissingPath},
{&datastore.Mock{}, "/v1/apps/a/routes", `{ "route": { "image": "iron/hello", "path": "myroute" } }`, http.StatusInternalServerError, models.ErrRoutesValidationInvalidPath}, {&datastore.Mock{}, "/v1/apps/a/routes", `{ "route": { "image": "iron/hello", "path": "myroute" } }`, http.StatusBadRequest, models.ErrRoutesValidationInvalidPath},
{&datastore.Mock{}, "/v1/apps/$/routes", `{ "route": { "image": "iron/hello", "path": "/myroute" } }`, http.StatusInternalServerError, models.ErrAppsValidationInvalidName}, {&datastore.Mock{}, "/v1/apps/$/routes", `{ "route": { "image": "iron/hello", "path": "/myroute" } }`, http.StatusInternalServerError, models.ErrAppsValidationInvalidName},
// success // success
{&datastore.Mock{}, "/v1/apps/a/routes", `{ "route": { "image": "iron/hello", "path": "/myroute" } }`, http.StatusCreated, nil}, {&datastore.Mock{}, "/v1/apps/a/routes", `{ "route": { "image": "iron/hello", "path": "/myroute" } }`, http.StatusOK, nil},
} { } {
rnr, cancel := testRunner(t) rnr, cancel := testRunner(t)
router := testRouter(test.mock, &mqs.Mock{}, rnr, tasks) router := testRouter(test.mock, &mqs.Mock{}, rnr, tasks)
@@ -212,7 +212,7 @@ func TestRouteUpdate(t *testing.T) {
Path: "/myroute/do", Path: "/myroute/do",
}, },
}, },
}, "/v1/apps/a/routes/myroute/do", `{ "route": { "path": "/otherpath" } }`, http.StatusForbidden, nil}, }, "/v1/apps/a/routes/myroute/do", `{ "route": { "path": "/otherpath" } }`, http.StatusBadRequest, nil},
} { } {
rnr, cancel := testRunner(t) rnr, cancel := testRunner(t)
router := testRouter(test.ds, &mqs.Mock{}, rnr, tasks) router := testRouter(test.ds, &mqs.Mock{}, rnr, tasks)

13
api/server/routes_update.go
View File

@@ -25,14 +25,14 @@ func (s *Server) handleRouteUpdate(c *gin.Context) {
} }
if wroute.Route == nil { if wroute.Route == nil {
log.WithError(err).Error(models.ErrInvalidJSON) log.Debug(models.ErrRoutesMissingNew)
c.JSON(http.StatusBadRequest, simpleError(models.ErrRoutesMissingNew)) c.JSON(http.StatusBadRequest, simpleError(models.ErrRoutesMissingNew))
return return
} }
if wroute.Route.Path != "" { if wroute.Route.Path != "" {
log.Debug(models.ErrRoutesPathImmutable) log.Debug(models.ErrRoutesPathImmutable)
c.JSON(http.StatusForbidden, simpleError(models.ErrRoutesPathImmutable)) c.JSON(http.StatusBadRequest, simpleError(models.ErrRoutesPathImmutable))
return return
} }
@@ -44,14 +44,19 @@ func (s *Server) handleRouteUpdate(c *gin.Context) {
Image: wroute.Route.Image, Image: wroute.Route.Image,
}) })
if err != nil { if err != nil {
c.JSON(http.StatusInternalServerError, simpleError(models.ErrUsableImage)) log.WithError(err).Debug(models.ErrRoutesUpdate)
c.JSON(http.StatusBadRequest, simpleError(models.ErrUsableImage))
return return
} }
} }
route, err := s.Datastore.UpdateRoute(ctx, wroute.Route) route, err := s.Datastore.UpdateRoute(ctx, wroute.Route)
if err != nil { if err == models.ErrRoutesNotFound {
log.WithError(err).Debug(models.ErrRoutesUpdate) log.WithError(err).Debug(models.ErrRoutesUpdate)
c.JSON(http.StatusNotFound, simpleError(err))
return
} else if err != nil {
log.WithError(err).Error(models.ErrRoutesUpdate)
c.JSON(http.StatusInternalServerError, simpleError(models.ErrRoutesUpdate)) c.JSON(http.StatusInternalServerError, simpleError(models.ErrRoutesUpdate))
return return
} }

6
api/server/server_test.go
View File

@@ -104,11 +104,11 @@ func TestFullStack(t *testing.T) {
body string body string
expectedCode int expectedCode int
}{ }{
{"create my app", "POST", "/v1/apps", `{ "app": { "name": "myapp" } }`, http.StatusCreated}, {"create my app", "POST", "/v1/apps", `{ "app": { "name": "myapp" } }`, http.StatusOK},
{"list apps", "GET", "/v1/apps", ``, http.StatusOK}, {"list apps", "GET", "/v1/apps", ``, http.StatusOK},
{"get app", "GET", "/v1/apps/myapp", ``, http.StatusOK}, {"get app", "GET", "/v1/apps/myapp", ``, http.StatusOK},
{"add myroute", "POST", "/v1/apps/myapp/routes", `{ "route": { "name": "myroute", "path": "/myroute", "image": "iron/hello" } }`, http.StatusCreated}, {"add myroute", "POST", "/v1/apps/myapp/routes", `{ "route": { "name": "myroute", "path": "/myroute", "image": "iron/hello" } }`, http.StatusOK},
{"add myroute2", "POST", "/v1/apps/myapp/routes", `{ "route": { "name": "myroute2", "path": "/myroute2", "image": "iron/error" } }`, http.StatusCreated}, {"add myroute2", "POST", "/v1/apps/myapp/routes", `{ "route": { "name": "myroute2", "path": "/myroute2", "image": "iron/error" } }`, http.StatusOK},
{"get myroute", "GET", "/v1/apps/myapp/routes/myroute", ``, http.StatusOK}, {"get myroute", "GET", "/v1/apps/myapp/routes/myroute", ``, http.StatusOK},
{"get myroute2", "GET", "/v1/apps/myapp/routes/myroute2", ``, http.StatusOK}, {"get myroute2", "GET", "/v1/apps/myapp/routes/myroute2", ``, http.StatusOK},
{"get all routes", "GET", "/v1/apps/myapp/routes", ``, http.StatusOK}, {"get all routes", "GET", "/v1/apps/myapp/routes", ``, http.StatusOK},

32
docs/swagger.yml
View File

@@ -6,7 +6,7 @@ swagger: '2.0'
info: info:
title: IronFunctions title: IronFunctions
description: The open source serverless platform. description: The open source serverless platform.
version: "0.1.25" version: "0.1.26"
# the domain of the service # the domain of the service
host: "127.0.0.1:8080" host: "127.0.0.1:8080"
# array of all schemes that your API supports # array of all schemes that your API supports
@@ -66,8 +66,8 @@ paths:
description: Parameters are missing or invalid. description: Parameters are missing or invalid.
schema: schema:
$ref: '#/definitions/Error' $ref: '#/definitions/Error'
500: 409:
description: Could not accept app due to internal error. description: App already exists.
schema: schema:
$ref: '#/definitions/Error' $ref: '#/definitions/Error'
default: default:
@@ -149,8 +149,8 @@ paths:
description: Parameters are missing or invalid. description: Parameters are missing or invalid.
schema: schema:
$ref: '#/definitions/Error' $ref: '#/definitions/Error'
500: 404:
description: Could not accept app due to internal error. description: App does not exist.
schema: schema:
$ref: '#/definitions/Error' $ref: '#/definitions/Error'
default: default:
@@ -161,7 +161,7 @@ paths:
/apps/{app}/routes: /apps/{app}/routes:
post: post:
summary: Create new Route summary: Create new Route
description: Create a new route description: Create a new route in an app, if app doesn't exists, it creates the app
tags: tags:
- Routes - Routes
parameters: parameters:
@@ -177,16 +177,16 @@ paths:
schema: schema:
$ref: '#/definitions/RouteWrapper' $ref: '#/definitions/RouteWrapper'
responses: responses:
201: 200:
description: Route created description: Route created
schema: schema:
$ref: '#/definitions/RouteWrapper' $ref: '#/definitions/RouteWrapper'
400: 400:
description: One or more of the routes were invalid due to parameters being missing or invalid. description: Invalid route due to parameters being missing or invalid.
schema: schema:
$ref: '#/definitions/Error' $ref: '#/definitions/Error'
500: 409:
description: Could not accept routes due to internal error. description: Route already exists.
schema: schema:
$ref: '#/definitions/Error' $ref: '#/definitions/Error'
default: default:
@@ -210,6 +210,10 @@ paths:
description: Route information description: Route information
schema: schema:
$ref: '#/definitions/RoutesWrapper' $ref: '#/definitions/RoutesWrapper'
404:
description: App does not exist.
schema:
$ref: '#/definitions/Error'
default: default:
description: Unexpected error description: Unexpected error
schema: schema:
@@ -239,16 +243,16 @@ paths:
schema: schema:
$ref: '#/definitions/RouteWrapper' $ref: '#/definitions/RouteWrapper'
responses: responses:
201: 200:
description: Route updated description: Route updated
schema: schema:
$ref: '#/definitions/RouteWrapper' $ref: '#/definitions/RouteWrapper'
400: 400:
description: One or more of the routes were invalid due to parameters being missing or invalid. description: Invalid route due to parameters being missing or invalid.
schema: schema:
$ref: '#/definitions/Error' $ref: '#/definitions/Error'
500: 404:
description: Could not accept routes due to internal error. description: App does not exist.
schema: schema:
$ref: '#/definitions/Error' $ref: '#/definitions/Error'
default: default: