Create your first API: Hello World
We are going to use mfserv module to create a web API.
First, we need to launch mfserv service. You could launch mfserv individually, but the easiest way is to use a command that will launch all installed metwork services at once. As root user:
service metwork start
Note: if you don’t have the
servicecommand installed, you can use/etc/rc.d/init.d/metwork startinstead
When it’s done, you can check that mfserv is working. Open this url in your browser: http://localhost:18868
You should see this:
Let’s create our first api. In MetWork Framework, we put our code in ‘plugins’. Thus, we are going to create our first plugin now.
When we installed mfserv module, the installer has created a ‘mfserv’ user. Let’s login as mfserv, and then create our plugin. We will call our plugin ‘hello’:
su - mfserv
cd ~
bootstrap_plugin.py create hello
Press enter several times to accept default values.
Now we need to launch our plugin. We launch it in ‘develop’ mode. In this mode, every modification to our plugin code will immediately launch a build, and thus you will see them in the browser.
# As mfserv user
cd ~/hello
make develop
Open this url in your browser: http://localhost:18868/hello. You should get this:
If you get a bad gateway error, just wait a few seconds for your plugin to start, and try again.