سخت‌افزار خودتان را به VectoraLab متصل کنید

VectoraLab برای دریافت داده از انواع سخت‌افزارها طراحی شده است. کافی است دستگاه شما داده را با قرارداد JSON تعریف‌شده به API ارسال کند.

01

نحوه کار

VectoraLab به سخت‌افزار خاصی وابسته نیست؛ لایه‌ی واسط داده، ارتباط سخت‌افزار شما با API را مدیریت می‌کند.

سخت‌افزار شما
Gateway / MCU / PC
JSON
VectoraLab API
Device / Data
02

سخت‌افزارهای قابل پشتیبانی

می‌توانید از سخت‌افزار فعلی خود استفاده کنید؛ قرارداد JSON مستقل از نوع سخت‌افزار است.

STM32
ESP32
Raspberry Pi
Industrial PC
PLC + Gateway
سخت‌افزار سفارشی
03

راه‌اندازی مرحله‌به‌مرحله

راه‌اندازی اولیه فقط چند مرحله دارد.

یک Device بسازید

پس از فعال بودن Hardware Integration، از داشبورد یک دستگاه جدید ایجاد کنید و نام دستگاه و ماشین مربوطه را وارد کنید.

API Key را دریافت کنید

برای ارسال داده، API Key اختصاصی همان Device را در هدر Authorization قرار دهید.

Authorization: Bearer vl_YOUR_API_KEY

داده را با JSON ارسال کنید

بدنه‌ی درخواست باید شامل timestamp و signals باشد. محتوای signals می‌تواند بر اساس سخت‌افزار و سنسورهای شما متفاوت باشد.

داده را در VectoraLab دریافت کنید

آخرین داده‌ی دریافتی برای Device ذخیره می‌شود و وضعیت دستگاه به online تغییر می‌کند.

04

قرارداد داده JSON

قرارداد داده عمداً عمومی است تا به یک نوع سنسور یا سخت‌افزار محدود نشود.

{
  "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"
    }
  }
}
05

ارسال اولین داده

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 Key را در کد سمت سخت‌افزار یا gateway خود به‌صورت امن نگهداری کنید و آن را در payload قرار ندهید.
06

پاسخ موفق

در صورت دریافت موفق داده، API یک پاسخ ساده برمی‌گرداند.

{
  "ok": true,
  "deviceId": "YOUR_DEVICE_ID",
  "receivedAt": "2026-10-04T18:30:01.124Z"
}
07

خطاهای رایج

اگر درخواست رد شد، کد HTTP معمولاً دلیل مشکل را مشخص می‌کند.

400

بدنه JSON یا فرمت داده معتبر نیست.

401

API Key وجود ندارد یا معتبر نیست.

403

دسترسی Hardware Integration فعال نیست یا منقضی شده است.

404

دستگاه موردنظر پیدا نشد.

08

دسترسی و تمدید

Hardware Integration یک دسترسی ۳۰ روزه با تمدید دستی است.

$۴۰ برای ۳۰ روزهر پرداخت یک دوره‌ی ۳۰ روزه ایجاد می‌کند.
تمدید دستیتمدید خودکار وجود ندارد؛ برای دوره‌ی بعدی دوباره پرداخت می‌کنید.
اطلاعات دستگاه باقی می‌ماندبا پایان دوره، Device و تنظیمات حذف نمی‌شوند؛ فقط دسترسی سرویس متوقف می‌شود.

Hardware Integration را فعال کنید.

دسترسی کامل به مدت ۳۰ روز؛ تمدید به‌صورت دستی.

VectoraLab