یک Device بسازید
پس از فعال بودن Hardware Integration، از داشبورد یک دستگاه جدید ایجاد کنید و نام دستگاه و ماشین مربوطه را وارد کنید.
VectoraLab برای دریافت داده از انواع سختافزارها طراحی شده است. کافی است دستگاه شما داده را با قرارداد JSON تعریفشده به API ارسال کند.
VectoraLab به سختافزار خاصی وابسته نیست؛ لایهی واسط داده، ارتباط سختافزار شما با API را مدیریت میکند.
میتوانید از سختافزار فعلی خود استفاده کنید؛ قرارداد JSON مستقل از نوع سختافزار است.
راهاندازی اولیه فقط چند مرحله دارد.
پس از فعال بودن Hardware Integration، از داشبورد یک دستگاه جدید ایجاد کنید و نام دستگاه و ماشین مربوطه را وارد کنید.
برای ارسال داده، API Key اختصاصی همان Device را در هدر Authorization قرار دهید.
Authorization: Bearer vl_YOUR_API_KEYبدنهی درخواست باید شامل timestamp و signals باشد. محتوای signals میتواند بر اساس سختافزار و سنسورهای شما متفاوت باشد.
آخرین دادهی دریافتی برای Device ذخیره میشود و وضعیت دستگاه به online تغییر میکند.
قرارداد داده عمداً عمومی است تا به یک نوع سنسور یا سختافزار محدود نشود.
{
"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"
}
}
}Device ID داخل JSON قرار نمیگیرد؛ Device از روی 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"
}
}
}'در صورت دریافت موفق داده، API یک پاسخ ساده برمیگرداند.
{
"ok": true,
"deviceId": "YOUR_DEVICE_ID",
"receivedAt": "2026-10-04T18:30:01.124Z"
}اگر درخواست رد شد، کد HTTP معمولاً دلیل مشکل را مشخص میکند.
بدنه JSON یا فرمت داده معتبر نیست.
API Key وجود ندارد یا معتبر نیست.
دسترسی Hardware Integration فعال نیست یا منقضی شده است.
دستگاه موردنظر پیدا نشد.
Hardware Integration یک دسترسی ۳۰ روزه با تمدید دستی است.
دسترسی کامل به مدت ۳۰ روز؛ تمدید بهصورت دستی.