Version 1.2.0 (Latest)

API Integration Guide

써드파티 센서 및 컨트롤러를 FarmSense 클라우드에 연동하기 위한 RESTful API 명세입니다.

Endpoint Information

POSThttps://api.farmsense.kr/api/w1/sensors/telemetry

Authentication Required:
Header에 Authorization: Bearer [DEVICE_TOKEN]을 반드시 포함해야 합니다. 토큰은 '마이페이지 > 기기 관리'에서 발급받을 수 있습니다.

JSON Request Body

데이터는 반드시 UTF-8 인코딩된 JSON 포맷이어야 합니다. `value` 키는 Float 타입을 권장합니다.

telemetry_payload.jsonjson

{
  "device_id": "fs-node-a101",
  "timestamp": "2026-01-23T14:30:00Z", // ISO 8601 (UTC Recommended)
  "telemetry": {
    "temperature_air": 24.5,    // Unit: Celsius
    "humidity_air": 60.2,       // Unit: %
    "soil_moisture": -15.4,     // Unit: kPa (Tensiometer)
    "soil_ec": 1.2,             // Unit: dS/m
    "battery_voltage": 3.7      // Unit: V
  },
  "metadata": {
    "firmware_version": "v1.2.0",
    "rssi": -65
  }
}

Response Status Codes

201 Created

데이터가 성공적으로 수신 및 저장되었습니다.

401 Unauthorized

유효하지 않은 토큰입니다. 토큰을 재발급 받으세요.

422 Unprocessable Entity

JSON 형식이 잘못되었거나 필수 필드가 누락되었습니다.