Create Device

This endpoint allows you to create a new device.

SecurityApiKeyAuth
Request
Request Body schema: application/json
name
string <= 32 characters
type
string
Enum: "car" "truck" "bus" "bike" "drone" "scooter" "pedestrian" "motorcycle" "boat" "plane" "other"
description
string <= 400 characters
metadata
string <= 400 characters

Additional metadata about the device. This can be used to store any additional information about the device. It is a JSON object serialized as a string that can contain any key-value pairs.

Responses
201

Device created.

401

API key is incorrect or not provided.

403

User or API key does not have permission to access the resource.

post/devices
Request samples
application/json
{
  • "name": "string",
  • "type": "car",
  • "description": "string",
  • "metadata": "string"
}
Response samples
application/json
{
  • "id": 0,
  • "uid": "07cc67f4-45d6-494b-adac-09b5cbc7e2b5",
  • "name": "string",
  • "type": "car",
  • "description": "string",
  • "metadata": "string",
  • "status": "idle",
  • "tracksCount": 0,
  • "lastLocation": {
    • "latitude": -90,
    • "longitude": -180
    },
  • "secret": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z"
}
Copyright © PickPoint.io LLC 2024. All rights reserved.