Compute Services

Exposing OpenWhisk RESTful APIs with API Gateway

Share this post:

openwhisk-hero-image API GatewayWith the recent promotion of OpenWhisk to general availability, you not only get the incredibly powerful, scalable, event-driven programming model for building your actions (functions) using serverless computing, but something else slipped into the release that you may not have noticed:

The OpenWhisk API Gateway

The API gateway is an experimental new feature that enables you to easily expose your OpenWhisk actions as RESTful endpoints. You can assign actions to specific endpoints, and even have verbs (get, put, post, delete) from the same endpoint assigned to different actions. You can already consume OpenWhisk actions from other applications using the JavaScript or iOS/Swift client SDKs, and now the API gateway gives you an easy path to expose your OpenWhisk actions to other non-credentialed applications.

There will be two different approaches you can to expose your actions with the API gateway:

  • Assigning API endpoint/verb combinations to specific actions individually
  • Using a Swagger config file to map API endpoints to actions (currently still in development)

Note: This is different from the ability to expose your OpenWhisk actions as managed APIs using API Connect.

A simple action: Fibonacci generator

Next we will examine how to expose an action as a REST API, but first let’s take a look at the action itself. I’m starting with a fibonacci generator. It’s a relatively simple action that generates numbers in a fibonacci sequence, where every number after the first two is the sum of the two preceding values. When invoking this action from the command line, you specify a num parameter (for the Nth place in the sequence), and it will return the value, the complete sequence, and the number of recursive invocations of the fibonacci method:

$ wsk action invoke fibonacci -p num 5 -b -r
{
   "n": 5,
   "value": 8,
   "sequence": [1, 1, 2, 3, 5, 8],
   "invocations": 9
}

You can download it and check it out for yourself: fibonacci.js

Mapping actions to endpoints

Now, let’s examine how a specific action can be associated with an API endpoint/verb. From the OpenWhisk CLI, you must specify a base path, the api path (path component for the action), the verb (get, post, put, delete), and then the action.  See more variations in the docs.

In this case, the base path is is /api-demo/v1, the api path is /fibonacci, the verb is get, and the action is fibonacci:

$ wsk api-experimental create /api-demo/v1 /fibonacci get fibonacci
ok: created API /api-demo/v1/fibonacci GET for action /_/fibonacci
https://7d10434f-b155-45ae-be03-a8a40cfb74e5-gws.api-gw.mybluemix.net/api-demo/v1/fibonacci

This exposed my fibonacci action as a get request for the URL shown directly above. You can check it out with different fibonacci values here:

Parameters that are passed via the query string will be available in the args object passed into the action’s main function.  For example, a query string parameter ?num=10 will be passed into your OpenWhisk args as:

{
  "num":10
}

View the fibonacci links above to see how I am passing data into this API endpoint.

Next Steps

If you haven’t already, be sure to download the latest command line interface. For additional information, be sure to check out the docs within the OpenWhisk project’s repo, and you can always run wsk api-experimental —help for ore detail in the CLI. Keep in mind, this is an early, experimental feature that provides users an early opportunity to try it out and provide feedback. We’ve already received several enhancement requests, but definitely let the team know if there are other things you’d like to see added.


Ron

How does the OpenWhisk API gateway compare with the gateways, DataPower and Microgateway, that are offered in API Connect?


    sjblanes

    API Connect’s gateways has throttling and analytics features as part of an API Management solution.

    OpenWhisk API gateway follows a simple api-gateway pattern.


Sorin

Is this available on Ubuntu?

I could successfully create and use the api-experiment using vagrant but on ubuntu I get a 502 when trying to access it, even the creation of the api seems to be working.

Also, I noticed that the api gateway installation is missing from the instructions available for ubuntu. I suppose this is on purpose.

Can you please clarify?

Comments are closed.

More Trending Stories

Utilizing Multi-Container Functionality with IBM Cloud Developer Tools CLI

The latest update to the IBM Cloud Developer Tools CLI, version 1.1.0, provides support for applications that use multiple containers which are configured using Docker Compose yaml files. These files contain necessary information about the containers you wish to run. With Docker installed, you already have the requisite dependency to run multiple containers locally.

Continue reading

IBM Cloud Log Analysis – Now Available in Germany and Sydney!

Starting today, IBM Cloud Log Analysis expands its availability from US-South to include the Germany and Sydney regions. Empower your DevOps team with IBM Cloud Log Analysis. Gain insights into your environment to quickly detect, diagnose, and identify issues. Keep your log data and your application workloads safeguarded on a centralized cloud class economical storage solution. Visit us in the IBM Cloud Catalog.

Continue reading

Simplify binding your IBM Cloud services to serverless Functions

Introducing a new command for the IBM Cloud Functions CLI plug-in to make it easier to configure your actions to have access to your IBM Cloud service credentials. The new service command is a convenient way to make your IBM Cloud service credentials available to your Cloud Functions code at run time. The new command helps with a form of secret management for your IBM Cloud services within the context of IBM Cloud Functions.

Continue reading