Skip to main content

web API to control Raspberry Pi GPIO

Project description

API to access Raspberry Pi GPIO based on Python, Flask & Rpi.GPIO library. The software launches an web API that controls IO pins using the Rpi.GPIO library.

This was meant to be used to remotely control relays, thus, it only sets the outputs as high or low.

The pins are referenced through their number printed in the board. Further information about pins can be found here.


Route Request Description
/api/gpio/ GET Returns a json object with the status of all pins
/api/gpio/power/<PIN> GET Returns a json object with the power pins position and description (5V, 3V3, GND)
/api/gpio/io/<PIN> GET Returns a json object with de description and status for a pin. If no pin number is given, returns the status of all io pins.
/api/gpio/io/<PIN> POST Sets up a particular pin. Receives a json object that must have the keys type and value. type must be a string with either input or output and value must be a boolean, with the status to write to the channel of the request.

Sample response

    "io": [
            "pin": 3,
            "pin_function": "IO",
            "pin_state": 1

    "power_pins": [
            "pin": 1,
            "pin_function": "3V3 Power"


Latest release through PyPI:

$ pip install pi_gpio_api

Development version:

$ git clone
$ cd pi-gpio-api
$ pip install -e .


The api can be run as a daemon using the gpioapi command in the Raspberry Pi shell.

$ gpioapi -h
usage: gpioapi [-h] [-H HOST] [-p PORT] command

GPIO web API controller

positional arguments:
  command               Control process: start, stop, restart, status

optional arguments:
  -h, --help            show this help message and exit
  -H HOST, --host HOST  host where the web server will be listening
  -p PORT, --port PORT  port where the web server will be listening

This way, the API can be launched through gpioapi start and stopped through gpioapi stop.

Use as a library

In a python shell:

>>> import pi_gpio_api
>>>'', port=5000)

This will launch a server that listens requests on the given host & port.


Feel free to open issues, report bugs or open pull requests.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pi-gpio-api, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size pi_gpio_api-0.1.1-py3-none-any.whl (7.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pi-gpio_api-0.1.1.tar.gz (6.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page