Layer

get layers

get

/api/v3/layers

Authorizations

Query parameters

orderbystring

Sorting parameter Available values : entity fields Default value : id

Example: id

orderstring

Sorting parameter Available values : [ASC,DESC] Default value : ASC

Example: asc

limitinteger · int32

Paging parameter Default value : null

Example: 2

offsetinteger · int32

Paging parameter Default value : 0

Example: 3

activeboolean

Filter Parameter check the type

Example: true

typestring

Filter Parameter check the type Available values : [wms,geojson]

Example: geojson

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/layers' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

401

200

{
  "count": 1,
  "limit": "text",
  "offset": 1,
  "order": "text",
  "orderby": "text",
  "curr": "text",
  "next": "text",
  "prev": "text",
  "total_count": 1,
  "results": [
    {
      "id": 1,
      "url": "text",
      "name": "text",
      "data_url": "text",
      "media": "text",
      "type": "text",
      "options": {
        "layers": "text",
        "format": "text",
        "transparent": true
      },
      "active": true,
      "visible_by_default": true,
      "created": "text",
      "updated": "text",
      "allowed_privileges": [
        "text"
      ]
    }
  ]
}

OK

add layer

POST https://ushahididocs.api.ushahidi.io/api/v3/layers

Request Body

Name	Type	Description
name	String	Layer name
visible_by_default	Boolean	Set True to make the layer visible by default and False to not
active	Boolean	Set True for active layer and False for Inactive layer
options	Array	Contains an array of layer options
type	String	Layer type
media	String	media
data_url	String	Data source URL

200: OK

{
    "id": 4,
    "url": "http://localhost:8000/api/v3/layer/4",
    "name": "test",
    "data_url": "http://services.nationalmap.gov/ArcGIS/services/NEXRAD_Weather/MapServer/WMSServer",
    "media": null,
    "type": "geojson",
    "options": null,
    "active": true,
    "visible_by_default": true,
    "created": "2022-11-02T19:20:43+00:00",
    "updated": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}

edit layer

PUT https://ushahididocs.api.ushahidi.io/api/v3/layers/1

Request Body

Name	Type	Description
name	String	Layer name
visible_by_default	Boolean	Set True to make the layer visible by default and False to not
active	Boolean	Set True for active layer and False for Inactive layer
options	Array	Contains an array of layer options
type	String	Layer type
media	String	media
data_url	String	Data source URL

200: OK

{
    "id": 4,
    "url": "http://localhost:8000/api/v3/layer/4",
    "name": "test",
    "data_url": "http://services.nationalmap.gov/ArcGIS/services/NEXRAD_Weather/MapServer/WMSServer",
    "media": null,
    "type": "geojson",
    "options": null,
    "active": true,
    "visible_by_default": true,
    "created": "2022-11-02T19:20:43+00:00",
    "updated": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}

get layer

get

/api/v3/layers/1

Authorizations

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/layers/1' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

401

404

200

{
  "id": 1,
  "url": "http://localhost:8000/api/v3/layer/1",
  "name": "test",
  "data_url": "/media/test.geojson",
  "type": "geojson",
  "active": true,
  "visible_by_default": true,
  "created": "1970-01-01T00:00:00+00:00",
  "options": [],
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search"
  ]
}

OK

delete layer

delete

/api/v3/layers/5

Authorizations

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/layers/5' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

401

404

200

{
  "id": 5,
  "url": "http://localhost:8000/api/v3/layer/5",
  "name": "test",
  "data_url": "http://services.nationalmap.gov/ArcGIS/services/NEXRAD_Weather/MapServer/WMSServer",
  "type": "geojson",
  "active": true,
  "visible_by_default": true,
  "created": "2022-11-02T19:21:27+00:00",
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search"
  ]
}

OK