HTTP API

This project provides access to dffml APIs via an HTTP interface.

It exposes a REST-like API which mimics that of dffml’s command line interface (CLI) and usage as Python module.

You can install the HTTP API service via pip

$ python3 -m pip install dffml-service-http

If you want to install the latest development version, clone dffml and install from you can use git+

$ git clone https://github.com/intel/dffml
$ python3 -m pip install -e dffml/service/http[dev]

If you want to run this securely you can see Security.

For an insecure setup, which might be easier for you to get started with for development purposes. You can run the service via DFFML service command.

The default port is 8080. You can change this with the -port flag. Also, by default the service is only accessible via 127.0.0.1 or localhost. To allow connections from machines other than the machine running the HTTP API, add the -addr 0.0.0.0. This tells the server to allow connections coming from anywhere on your network. If your running this on a public server, your network is the internet, which is dangerous. Also since your web app you’re using for development is probably hosted on another port, you’ll need the cors flag.

Warning

By no means should you use the following command in a production environment! You should instead see the Security docs!

$ dffml service http server -insecure -cors '*' -addr 0.0.0.0 -port 8080