Project

General

Profile

APIs » History » Version 2

Version 1 (Philippe May, 05/04/2021 11:27) → Version 2/11 (Philippe May, 05/04/2021 11:35)

h1. APIs

Gisaf's web interface uses server's APIs, that can also be used for third party software integration, eg. for retrieving data from the database with HTTP requests.

The APIs use 2 technologies: json REST stores and Graphql.

This page is a work-in-progress documentation effort. Refer effort - refer to source code for a comprehensive and up to date API list and usage:

* https://redmine.auroville.org.in/projects/gisaf/repository/revisions/master/entry/gisaf/api.py
* https://redmine.auroville.org.in/projects/gisaf/repository/revisions/master/entry/gisaf/graphql_api.py

It's also easy to track the HTTP requests in use by the web site, using standard web development tools like those embedded in all modern browsers.

h2. Json stores

h3. Getting record values from devices

For the custom models that define time-based values, eg. fetched from "IoT" enabled devices such as weather stations or other sensors, the generic HTTP request scheme is:

<pre>
<http_request_prefix>/api/<store>/values/<value>?<parameters> /api/avsm_misc.weather_station/values/temperature?where=%7B%22avsm_misc.weather_station%22:4%7D&sort=%7B%22time%22:false%7D&resample=H
</pre>

Where:

* http_request_prefix: base URI base of the site (eg. "https://gis.auroville.org.in")
* store: name of the store of the geographical feature (eg. "avsm_misc.weather_station")
* value: name of the value for the store (eg. "temperature")
* parameters: URL-encoded query string, see below for details.

h4. Parameters