Remote Platform

UWB API v1

The UWB API provides access to the ultra-wideband (UWB) service.

List tag devices

GET
/api/v1/client/iot/uwb/{projectId}/tags

Authorization

x-api-key<token>

In: header

Path Parameters

projectIdRequirednumber

Response Body

responseRequiredarray<object>
statusCodeRequirednumber

Error code.

errorRequiredstring

Error.

resultCodestring

Custom error code.

messageRequiredstring

Error message.

detailsRequiredobject

Details of the error. When the error is a validation error, this will be an array of objects.

Format: "object"
requestIdRequiredstring

Unique request id.

timestampRequiredstring

Timestamp of the error.

pathRequiredstring

Path of the request.

statusCodeRequirednumber

Error code.

errorRequiredstring

Error.

resultCodestring

Custom error code.

messageRequiredstring

Error message.

requestIdRequiredstring

Unique request id.

timestampRequiredstring

Timestamp of the error.

pathRequiredstring

Path of the request.

curl -X GET "https://staging.saharobotik.com/api/v1/client/iot/uwb/0/tags" \
  -H "x-api-key: <token>"
fetch("https://staging.saharobotik.com/api/v1/client/iot/uwb/0/tags", {
  headers: {
    "x-api-key": "<token>"
  }
})
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://staging.saharobotik.com/api/v1/client/iot/uwb/0/tags"

  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("x-api-key", "<token>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://staging.saharobotik.com/api/v1/client/iot/uwb/0/tags"

response = requests.request("GET", url, headers = {
  "x-api-key": "<token>"
})

print(response.text)
[
  {
    "id": "string",
    "label": "string",
    "online": true
  }
]
{
  "statusCode": 0,
  "error": "string",
  "resultCode": "string",
  "message": "string",
  "details": [
    {
      "property": "foo",
      "constraints": [
        "foo is required"
      ]
    }
  ],
  "requestId": "string",
  "timestamp": "string",
  "path": "string"
}
{
  "statusCode": 500,
  "error": "Internal Server Error",
  "resultCode": "string",
  "message": "string",
  "requestId": "string",
  "timestamp": "string",
  "path": "string"
}

Send a buzzer ping command to tag device

POST
/api/v1/client/iot/uwb/{projectId}/buzzer-ping

Authorization

x-api-key<token>

In: header

Request Body

application/jsonRequired
labelRequiredstring

Path Parameters

projectIdRequirednumber

Response Body

successRequiredboolean
statusCodeRequirednumber

Error code.

errorRequiredstring

Error.

resultCodestring

Custom error code.

messageRequiredstring

Error message.

detailsRequiredobject

Details of the error. When the error is a validation error, this will be an array of objects.

Format: "object"
requestIdRequiredstring

Unique request id.

timestampRequiredstring

Timestamp of the error.

pathRequiredstring

Path of the request.

statusCodeRequirednumber

Error code.

errorRequiredstring

Error.

resultCodestring

Custom error code.

messageRequiredstring

Error message.

requestIdRequiredstring

Unique request id.

timestampRequiredstring

Timestamp of the error.

pathRequiredstring

Path of the request.

curl -X POST "https://staging.saharobotik.com/api/v1/client/iot/uwb/0/buzzer-ping" \
  -H "x-api-key: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "string"
  }'
const body = JSON.stringify({
  "label": "string"
})

fetch("https://staging.saharobotik.com/api/v1/client/iot/uwb/0/buzzer-ping", {
  headers: {
    "x-api-key": "<token>"
  },
  body
})
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
  "strings"
)

func main() {
  url := "https://staging.saharobotik.com/api/v1/client/iot/uwb/0/buzzer-ping"
  body := strings.NewReader(`{
    "label": "string"
  }`)
  req, _ := http.NewRequest("POST", url, body)
  req.Header.Add("x-api-key", "<token>")
  req.Header.Add("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://staging.saharobotik.com/api/v1/client/iot/uwb/0/buzzer-ping"
body = {
  "label": "string"
}
response = requests.request("POST", url, json = body, headers = {
  "x-api-key": "<token>",
  "Content-Type": "application/json"
})

print(response.text)
{
  "success": true
}
{
  "statusCode": 0,
  "error": "string",
  "resultCode": "string",
  "message": "string",
  "details": [
    {
      "property": "foo",
      "constraints": [
        "foo is required"
      ]
    }
  ],
  "requestId": "string",
  "timestamp": "string",
  "path": "string"
}
{
  "statusCode": 500,
  "error": "Internal Server Error",
  "resultCode": "string",
  "message": "string",
  "requestId": "string",
  "timestamp": "string",
  "path": "string"
}