Activate a new sensor

POST

/sensors

Activate a new sensor with an activation code

Header Parameters

Authorizationstringrequired
Example
```
{
  "Authorization": "Bearer {jwt token}"
}
```
Description
Auth header

Body Parameters

bodyobjectrequired
Example
```
{
  "hw_serial": "SE01000000",
  "activation_code": "AAAA-BBBB-CCCC-DDDD"
}
```
- hw_serialstringrequired
  Description
  hardware serial number of sensor
- activation_codestringrequired
  Description
  activation code of the sensor

Responses

201Created

object
- _idstring
- hw_serialstring
  Example
  SE01000000
- statusnumber
  Example
  1
- user_idstring
- fw_versionstring
- sensor_profileobject
  Example
```
{
  "label": "My sensor",
  "street_and_number": "Flurstrasse 30",
  "zip_code": 8048,
  "city": "Zürich",
  "country": "sui"
}
```
- sensor_typestring
  Example
  clemap_lm

400Bad Request

object
- namestring
  Example
  BadRequest
  Description
  Error name
- messagestring
  Example
  Data does not match schema
  Description
  Error message
- codenumber
  Example
  400
  Description
  HTTP status code
- classNamestring
  Example
  bad-request
  Description
  Error class name
- datastring
  Description
  Error data
- errorsobject[]
  Example
```
[
  "detailed description of error"
]
```
  Description
  Description of errors

401Unauthorized

object
- namestring
  Example
  NotAuthenticated
  Description
  Error name
- messagestring
  Example
  Not authenticated
  Description
  Error message
- codenumber
  Example
  401
  Description
  HTTP status code
- classNamestring
  Example
  not-authenticated
  Description
  Error class name
- errorsobject
  Description
  Description of errors

curl

curl --request POST \
     --url /sensors \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'authorization: {"Authorization":"Bearer {jwt token}"}' \
     --data '{
     "hw_serial": "",
     "activation_code": ""
     }'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
myHeaders.append("authorization", "{\"Authorization\":\"Bearer {jwt token}\"}");

var raw = JSON.stringify({
   "hw_serial": "",
   "activation_code": ""
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("/sensors", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("/sensors")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request["authorization"] = "{\"Authorization\":\"Bearer {jwt token}\"}"
request.body = JSON.dump({
   "hw_serial": "",
   "activation_code": ""
})

response = http.request(request)
puts response.read_body

python

import requests
import json

url = "/sensors"

payload = json.dumps({
   "hw_serial": "",
   "activation_code": ""
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json',
   'authorization': '{"Authorization":"Bearer {jwt token}"}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

201

// Created
{
  "_id": "",
  "hw_serial": "SE01000000",
  "status": 1,
  "user_id": "",
  "fw_version": "",
  "sensor_profile": {},
  "sensor_type": "clemap_lm"
}

400

// Bad Request
{
  "name": "BadRequest",
  "message": "Data does not match schema",
  "code": 400,
  "className": "bad-request",
  "data": "",
  "errors": [
    {}
  ]
}

401

// Unauthorized
{
  "name": "NotAuthenticated",
  "message": "Not authenticated",
  "code": 401,
  "className": "not-authenticated",
  "errors": {}
}

Activate a new sensor with an activation code