doompanning/demo/rest

= REST API Gateway demo

This is a somewhat contrived demonstration, but may be useful
in a pattern for solving real world problems.

There is a single "server" (rest-server) program, that does these:

. REST API at /api/rest/rot13 - this API takes data from HTTP POST commands,
  and forwards them to an NNG REQ socket.  When the REQ response comes,
  the reply is redirected back to the server.  (For the purposes of the
  demonstration, our server just performs ROT13 on input.)

. REP server (implemented in the same program using inproc, for demonstration
  purposes. In a real world scenario this might instead go to another
  process on another computer.)

[source, bash]
----
% env PORT=8888  # default
% ./rest-server &
% curl -d ABC http://127.0.0.1:8888/api/rest/rot13; echo
NOP
% curl -d ABC http://127.0.0.1:8888/api/rest/rot13; echo
ABC
----

== Compiling

To build the program, we recommend CMake and Ninja-Build.

[source, bash]
----
% mkdir build
% cd build
% cmake -G Ninja ..
% ninja
----

Alternatively, you can go old-school.
Here's the simplest option for Linux:

[source, bash]
----
% cc server.c -o rest-server -I /usr/local/include -lnng
----