Ulbora API Gateway

Get a free account on the Free Tier at: http://www.myapigateway.com

Multi-user lightweight API Gateway with a self service portal: http://www.myapigateway.com

Certain inventions and disclosures in this file may be claimed within patents owned or patent applications filed by Ulbora Labs LLC., or third parties.

User Admin Portal: https://github.com/Ulbora/ApiGatewayUserPortal.git

Features

Circuit Breaker
Health Check
Self Healing when breaker is open
Gateway Analytics
Blue/Green/Active Routes
Gateway Error Loggin
Admin Portal (written in Golang)

Using API Gateway Routes

The Ulbora API Gateway routes REST service calls to endpoints assigned through the user portal.
There can be multiple API endpoints mapped to any route; blue, green, or any name you choose.
CORS is passed through the gateway, so if CORS is enabled in your REST services, it works automatically in the gateway.
Authentication is also passed through the gateway. If you pass any type of token in a header, it will be passed through automatically.
Any other headers are also passed through the gateway automatically.
The gateway works with both JSON and XML bodies.

Headers For Gateway Route Calls

clientId: Your assigned client id
apiKey: Your assigned API Key
Any other headers required for your micro services

Allowed HTTP Methods

POST
PUT
PATCH
GET
DELETE
OPTIONS

Gateway Routes

Local Non-Prod

http://localhost:3011/np/routeID/routeName/yourRoute
(example): http://localhost:3011/np/challenge/blue/rs/challenge/en_us?g=g&b=b
Note:
routeID is: challenge
routeName is: blue
yourRoute is: rs/challenge/en_us?g=g&b=b which can be mappend in the user portal to something like https://www.youapi/rs/challenge/en_us?g=g&b=b

Local Prod

http://localhost:3011/routeID/yourRoute
(example): http://localhost:3011/challenge/rs/challenge?name=sam&age=44
Note:
routeID is: challenge
yourRoute is: /rs/challenge?name=sam&age=44 which can be mappend in the user portal to something like https://www.youapi/rs/challenge?name=sam&age=44

Active Production Route

The User Admin Portal allows you to make any route URL the active production route with the click of a switch. Using Non-Prod routes allows you to test services before placing them in production.

Super Admin REST Services

Headers

Content-Type: application/json (for POST and PUT)
Authorization: Bearer aToken (POST, PUT, GET and DELETE.)
clientId: clientId (example 33477)

Add Client

POST:
URL: http://localhost:3011/rs/gwClient/add

Example Request
{  
   "clientId":4,
   "apiKey":"112233",
   "enabled":true,
   "level":"small"
}

Example Response   

{
    "success": true,
    "id": 19
}

Update client

PUT:
URL: http://localhost:3011/rs/gwClient/update

Example Request
{  
   "clientId":4,
   "apiKey":"55555",
   "enabled":true,
   "level":"small"
}

Example Response   

{
    "success": true,
    "id": 11
}

Get Client

GET:
URL: http://localhost:3011/rs/gwClient/get/4

Example Response   

{  
   "clientId":4,
   "apiKey":"55555",
   "enabled":true,
   "level":"small"
}

Get Client List

GET:
URL: http://localhost:3011/rs/gwClient/list

Example Response   

[
    {  
        "clientId":4,
        "apiKey":"555525",
        "enabled":true,
        "level":"small"
    },
    {
        "clientId":5,
        "apiKey":"5553355",
        "enabled":true,
        "level":"small"
    },
    {
        "clientId":6,
        "apiKey":"5555445",
        "enabled":true,
        "level":"small"
    }
]

Delete Client

DELETE:
URL: http://localhost:3011/rs/gwClient/delete/1

Example Response   

{
    "success": true,
    "id": 1
}

Add Route

POST:
URL: http://localhost:3011/rs/gwRestRouteSuper/add

Example Request
{  
   "clientId":4,
   "route":"mail"
}

Example Response   

{
    "success": true,
    "id": 19
}

Update Route

PUT:
URL: http://localhost:3011/rs/gwRestRouteSuper/update

Example Request
{  
   "id": 84,
   "clientId":4,
   "route":"mailChimp"
}

Example Response   

{
    "success": true,
    "id": 84
}

Get Route

GET:
URL: http://localhost:3011/rs/gwRestRouteSuper/get/84/4

Example Response   

{  
   "id": 84,
   "clientId":4,
   "route":"mail"
}

Get Route List

GET:
URL: http://localhost:3011/rs/gwRestRouteSuper/list/4

Example Response   

[
    {  
        "id": 84,
        "clientId":4,
        "route":"mail"
    },
    {
        "id": 85,
        "clientId":4,
        "route":"content"
    },
    {
        "id": 86,
        "clientId":4,
        "route":"products"
    }
]

Delete Route

DELETE:
URL: http://localhost:3011/rs/gwRestRouteSuper/delete/85/4

Example Response   

{
    "success": true,
    "id": 85
}

Add Route URL

POST:
URL: http://localhost:3011/rs/gwRouteUrlSuper/add

Example Request
{  
   "routeId":87,
   "clientId": 403,
   "name": "testMail",
   "url": "google.com/test1"
}

Example Response   

{
    "success": true,
    "id": 19
}

Update Route URL

PUT:
URL: http://localhost:3011/rs/gwRouteUrlSuper/update

Example Request
{  
   "id": 188,
   "routeId":87,
   "clientId": 403,
   "name": "testMailGreen",
   "url": "google.com/test1"
}

Example Response   

{
    "success": true,
    "id": 188
}

Activate Route URL

PUT:
URL: http://localhost:3011/rs/gwRouteUrlSuper/activate

Example Request
{  
   "id": 188,
   "routeId":87,
   "clientId": 403
}

Example Response   

{
    "success": true,
    "id": 188
}

Get Route URL

GET:
URL: http://localhost:3011/rs/gwRouteUrlSuper/get/188/87/403

Example Response   

{  
    "id": 188,
    "routeId":87,
    "clientId": 403,
    "name": "testMailGreen",
    "url": "google.com/test1"
}

Get Route URL List

GET:
URL: http://localhost:3011/rs/gwRouteUrlSuper/list/87/403

Example Response   

[
    {
        "id": 188,
        "name": "testMailGreen",
        "url": "google.com/test1",
        "active": true,
        "routeId": 87,
        "clientId": 403
    },
    {
        "id": 189,
        "name": "testMail",
        "url": "google.com/test1",
        "active": false,
        "routeId": 87,
        "clientId": 403
    }
]

Delete Route URL

DELETE:
URL: http://localhost:3011/rs/gwRouteUrlSuper/delete/190/87/403

Example Response   

{
    "success": true,
    "id": 190
}

Add Breaker

POST:
URL: http://localhost:3011/rs/gwBreakerSuper/add

Example Request
{
   "failureThreshold":3,
   "healthCheckTimeSeconds":60,
   "failoverRouteName":"red",
   "openFailCode":501,
   "routeId":22,
   "routeUriId":33,
   "clientId":403
}

Example Response   

{
    "success": true,
    "id": 19
}

Update Breaker

PUT:
URL: http://localhost:3011/rs/gwBreakerSuper/update

Example Request
{
   "id": 620,
   "failureThreshold":3,
   "healthCheckTimeSeconds":120,
   "failoverRouteName":"red",
   "openFailCode":501,
   "routeId":22,
   "routeUriId":33,
   "clientId":403
}

Example Response   

{
    "success": true,
    "id": 84
}

Get Breaker

GET:
URL: http://localhost:3011/rs/gwBreakerSuper/get/33/22/403

Example Response   

{  
   "id": 84,
   "clientId":4,
   "route":"mail"
}

Delete Breaker

DELETE:
URL: http://localhost:3011/rs/gwBreakerSuper/delete/33/22/403

Example Response   

{
    "success": true
    
}

Get Errors

GET:
URL: http://localhost:3011/rs/gwErrorsSuper

Example Response   

{
   "routeId":22,
   "routeUriId":33,
   "clientId":403
}

Get Performance

GET:
URL: http://localhost:3011/rs/gwPerformanceSuper

Example Response   

{
   "routeId":22,
   "routeUriId":33,
   "clientId":403
}

Admin REST Services (User Portal)

Headers

Content-Type: application/json (for POST and PUT)
Authorization: Bearer aToken (POST, PUT, GET and DELETE.)
clientId: clientId (example 33477)

Add Route

POST:
URL: http://localhost:3011/rs/gwRestRoute/add

Example Request
{     
   "route":"mail"
}

Example Response   

{
    "success": true,
    "id": 19
}

Update Route

PUT:
URL: http://localhost:3011/rs/gwRestRoute/update

Example Request
{  
   "id": 84,   
   "route":"mailChimp"
}

Example Response   

{
    "success": true,
    "id": 84
}

Get Route

GET:
URL: http://localhost:3011/rs/gwRestRoute/get/84

Example Response   

{  
   "id": 84,  
   "route":"mail"
}

Get Route List

GET:
URL: http://localhost:3011/rs/gwRestRoute/list

Example Response   

[
    {  
        "id": 84,
        "clientId":4,
        "route":"mail"
    },
    {
        "id": 85,
        "clientId":4,
        "route":"content"
    },
    {
        "id": 86,
        "clientId":4,
        "route":"products"
    }
]

Delete Route

DELETE:
URL: http://localhost:3011/rs/gwRestRoute/delete/85

Example Response   

{
    "success": true,
    "id": 85
}

Add Route URL

POST:
URL: http://localhost:3011/rs/gwRouteUrl/add

Example Request
{  
   "routeId":87,   
   "name": "testMail",
   "url": "google.com/test1"
}

Example Response   

{
    "success": true,
    "id": 19
}

Update Route URL

PUT:
URL: http://localhost:3011/rs/gwRouteUrl/update

Example Request
{  
   "id": 188,
   "routeId":87,   
   "name": "testMailGreen",
   "url": "google.com/test1"
}

Example Response   

{
    "success": true,
    "id": 188
}

Activate Route URL

PUT:
URL: http://localhost:3011/rs/gwRouteUrl/activate

Example Request
{  
   "id": 188,
   "routeId":87   
}

Example Response   

{
    "success": true,
    "id": 188
}

Get Route URL

GET:
URL: http://localhost:3011/rs/gwRouteUrl/get/188/87

Example Response   

{  
    "id": 188,
    "routeId":87,
    "clientId": 403,
    "name": "testMailGreen",
    "url": "google.com/test1"
}

Get Route URL List

GET:
URL: http://localhost:3011/rs/gwRouteUrl/list/87

Example Response   

[
    {
        "id": 188,
        "name": "testMailGreen",
        "url": "google.com/test1",
        "active": true,
        "routeId": 87,
        "clientId": 403
    },
    {
        "id": 189,
        "name": "testMail",
        "url": "google.com/test1",
        "active": false,
        "routeId": 87,
        "clientId": 403
    }
]

Delete Route URL

DELETE:
URL: http://localhost:3011/rs/gwRouteUrl/delete/190/87

Example Response   

{
    "success": true,
    "id": 190
}

Add Breaker

POST:
URL: http://localhost:3011/rs/gwBreaker/add

Example Request
{
   "failureThreshold":3,
   "healthCheckTimeSeconds":60,
   "failoverRouteName":"red",
   "openFailCode":501,
   "routeId":22,
   "routeUriId":33
}

Example Response   

{
    "success": true,
    "id": 19
}

Update Breaker

PUT:
URL: http://localhost:3011/rs/gwBreaker/update

Example Request
{
   "id": 620,
   "failureThreshold":3,
   "healthCheckTimeSeconds":120,
   "failoverRouteName":"red",
   "openFailCode":501,
   "routeId":22,
   "routeUriId":33
}

Example Response   

{
    "success": true,
    "id": 84
}

Get Breaker

GET:
URL: http://localhost:3011/rs/gwBreaker/get/33/22

Example Response   

{  
   "id": 84,
   "clientId":4,
   "route":"mail"
}

Delete Breaker

DELETE:
URL: http://localhost:3011/rs/gwBreaker/delete/33/22

Example Response   

{
    "success": true
    
}

Get Errors

GET:
URL: http://localhost:3011/rs/gwErrors

Example Request   

{
   "routeId":22,
   "routeUriId":33
}

Get Performance

GET:
URL: http://localhost:3011/rs/gwPerformance

Example Request   

{
   "routeId":22,
   "routeUriId":33
}

#Docker usage

Name		Name	Last commit message	Last commit date
Latest commit History 141 Commits
.scannerwork		.scannerwork
.vscode		.vscode
cache		cache
circuitbreaker		circuitbreaker
database		database
environment		environment
gwerrors		gwerrors
handlers		handlers
managers		managers
monitor		monitor
nbproject		nbproject
scripts		scripts
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
build.sh		build.sh
covTest		covTest
covTestOld		covTestOld
entrypoint.sh		entrypoint.sh
main		main
main.go		main.go
runCovTests.sh		runCovTests.sh
runTests.sh		runTests.sh
sonar-project.properties		sonar-project.properties
utilities.go		utilities.go

License

Ulbora/UlboraAPIGateway

Folders and files

Latest commit

History

Repository files navigation

Ulbora API Gateway

Features

Using API Gateway Routes

Headers For Gateway Route Calls

Allowed HTTP Methods

Gateway Routes

Local Non-Prod

Local Prod

Active Production Route

Super Admin REST Services

Headers

Add Client

Update client

Get Client

Get Client List

Delete Client

Add Route

Update Route

Get Route

Get Route List

Delete Route

Add Route URL

Update Route URL

Activate Route URL

Get Route URL

Get Route URL List

Delete Route URL

Add Breaker

Update Breaker

Get Breaker

Delete Breaker

Get Errors

Get Performance

Admin REST Services (User Portal)

Headers

Add Route

Update Route

Get Route

Get Route List

Delete Route

Add Route URL

Update Route URL

Activate Route URL

Get Route URL

Get Route URL List

Delete Route URL

Add Breaker

Update Breaker

Get Breaker

Delete Breaker

Get Errors

Get Performance

About

Topics

Resources

License

Stars

Watchers

Forks

Languages