Theme

IoTSP Services ​

API endpoints for IoTSP Services management in WORKSPACE.

Setup an IoTSP ​

http
POST /v1/:wid/iotsp/setup

Register & manage the platform. Eg. e-commerce application.

Headers ​

  • de-user-agent (required)
  • de-auth-token (required)
  • de-auth-device (required)

Request Body ​

typescript
interface Setup an IoTSPRequest {
  type: string;
  name: string;
  description: string;
  logo: string;
  contacts: {
    emails: string[];
    phones: string[]
  };
  address: {
    name: string;
    street1: string;
    city: string;
    state: string;
    country: string;
    coordinates: number[]
  };
}

Example:

json
{
  "type": "FLEET_TRACKING",
  "name": "Mijo IoT",
  "description": "Fleet tracking system via IoT",
  "logo": "https://pixels.con/304x399/pictusor-medata",
  "contacts": {
    "emails": [
      "[email protected]"
    ],
    "phones": [
      "+228 90 49 43 43",
      "+233 204 55323"
    ]
  },
  "address": {
    "name": "Manoa Susu",
    "street1": "3rd Road, MSBSI Schook, Mamprobi",
    "city": "Accra",
    "state": "Greater Accra",
    "country": "Ghana",
    "coordinates": [
      -0.3387423,
      5.4284859
    ]
  }
}

Get an IoTSP ​

http
GET /v1/:wid/iotsp/:xcode

Headers ​

  • de-user-agent (required)
  • de-auth-token (required)
  • de-auth-device (required)

Get All IoTSPs ​

http
GET /v1/:wid/iotsps

Headers ​

  • de-user-agent (required)
  • de-auth-token (required)
  • de-auth-device (required)

Request IoTSP Context ​

http
GET /v1/:wid/iotsp/:xcode/context

Headers ​

  • de-user-agent (required)
  • de-auth-token (required)
  • de-auth-device (required)

Update an IoTSP ​

http
PATCH /v1/:wid/iotsp/:xcode

Headers ​

  • de-user-agent (required)
  • de-auth-token (required)
  • de-auth-device (required)

Delete a IoTSP ​

http
DELETE /v1/:wid/iotsp/:xcode

Headers ​

  • de-user-agent (required)
  • de-auth-token (required)
  • de-auth-device (required)