Skip to main content

Working with API

This functionality requires an experimental server plugin. Read More

It's possible to start Frictionless API as a standalone server. This capability is highly experimental at the moment and it's not tested to be secure. Please don't use the server in production environment.

Install#

The API server are shipped as plugin so you need to install it with the core framework:

CLI
pip install frictionless[server]
pip install 'frictionless[server]' # for zsh shell

Server#

It's simple to start the API server:

CLI
frictionless api

Not you can make HTTP calls to:

http://localhost:8000

The API is the same as Python and Command-Line interfaces use.

Inputs#

All input data is expected to be in JSON format, for exmaple:

[POST] http://localhost:8000/extract

API
{
"source": "data/table.csv"
}

Ouputs#

All output data will be in JSON format, for example:

API
[
{
"id": 1,
"name": "english"
},
{
"id": 2,
"name": "中国人"
}
]

Debug#

Watch the command-line session when you ran frictionless api to get the server's logs.