Create a Device
With Hardware Integration active, create a device from your dashboard and provide its name and optional machine name.
VectoraLab is designed to accept data from different hardware platforms. Your device only needs to send data to the VectoraLab API using the defined JSON contract.
VectoraLab is not tied to a specific hardware platform. A gateway or application layer can handle the connection between your hardware and the API.
Use your existing hardware. The JSON contract is independent of the underlying hardware platform.
The initial setup only takes a few steps.
With Hardware Integration active, create a device from your dashboard and provide its name and optional machine name.
Use the API key assigned to that device in the Authorization header when sending data.
Authorization: Bearer vl_YOUR_API_KEYThe request body must contain timestamp and signals. The contents of signals can vary according to your hardware and sensors.
The latest received payload is stored for the device, and the device status is updated to online.
The data contract is intentionally generic so it is not limited to one sensor or hardware type.
{
"timestamp": "2026-10-04T18:30:00.000Z",
"signals": {
"vibration": {
"axis": {
"x": [0.12, 0.18, 0.09],
"y": [0.04, 0.07, 0.05],
"z": [0.31, 0.28, 0.34]
},
"sampleRate": 5000
},
"temperature": {
"value": 48.6,
"unit": "C"
}
}
}The device ID is not included in the JSON payload. The device is identified from its API key.
curl -X POST "https://vectoralab.site/api/hardware/data" \
-H "Authorization: Bearer vl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"timestamp": "2026-10-04T18:30:00.000Z",
"signals": {
"temperature": {
"value": 48.6,
"unit": "C"
}
}
}'When the payload is accepted, the API returns a simple success response.
{
"ok": true,
"deviceId": "YOUR_DEVICE_ID",
"receivedAt": "2026-10-04T18:30:01.124Z"
}If a request is rejected, the HTTP status usually identifies the problem.
Invalid JSON body or data format.
Missing or invalid API key.
Hardware Integration is inactive or expired.
The requested device was not found.
Hardware Integration provides 30 days of access with manual renewal.
Full access for 30 days, with manual renewal.