Providers

Providers is the term used to describe the logical or organisational unit responsible for a particular collection of networked devices. Typically this will be a data infrastructure provider or a company with a batch of devices that use a specific data infrastructure. Providers may include all open data, a combination of open and closed data, or be entirely closed.

Access to this endpoint always require authentication.

Get Provider

GET /providers/:id

Get a single provider with identifier id.

Example Request:

GET /providers/airqualitynetwork HTTP/1.1
Host: api.thingful.net
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Example Response:

HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Content-Type: application/vnd.api+json

{
  "data": {
    "type": "provider",
    "id": "airqualitynetwork",
    "attributes": {
      "name": "Air Quality Network",
      "description": "Global network of air quality data",
      "website": "http://airqualitynetwork.org",
      "icon_url": null,
      "admin": true
    }
  },
  "links": {
    "self": "https://api.thingful.net/v1/providers/airqualitynetwork"
  }
}
Parameters:
  • id – provider’s unique identifier
Request Headers:
 
  • Authorization – required authorization credentials supplied either as JWT based Bearer authentication or as properly encoded HTTP Basic credentials
Status Codes: