netpie rest api — คู่มือฉบับสมบูรณ์ 2026 | SiamCafe Blog

NETPIE REST API: ประตูสู่โลก IoT แบบครบวงจรสำหรับนักพัฒนาไทย

ในยุคที่ Internet of Things (IoT) กำลังเปลี่ยนโฉมการดำเนินชีวิตและธุรกิจ การมีแพลตฟอร์มกลางที่ช่วยจัดการอุปกรณ์ เชื่อมต่อข้อมูล และสร้างแอปพลิเคชันได้อย่างรวดเร็วนั้นถือเป็นปัจจัยสำคัญต่อความสำเร็จ สำหรับนักพัฒนาและองค์กรไทย NETPIE (Network Platform for Internet of Everything) โดย NECTEC ถือเป็นหนึ่งในแพลตฟอร์ม IoT ที่ทรงพลังและเข้าถึงง่ายที่สุด ด้วยการสนับสนุนทั้งในด้านเทคนิคและชุมชน ทำให้ NETPIE เป็นตัวเลือกอันดับต้นๆ สำหรับโปรเจกต์ IoT สไตล์ไทยแลนด์ 4.0 บทความคู่มือฉบับสมบูรณ์นี้จะเจาะลึกไปที่หัวใจสำคัญของการเชื่อมต่อนั่นคือ NETPIE REST API ซึ่งเป็นอินเทอร์เฟซมาตรฐานที่ช่วยให้ระบบหรือแอปพลิเคชันภายนอกสามารถสื่อสารกับแพลตฟอร์ม NETPIE ได้อย่างมีประสิทธิภาพ เราจะสำรวจตั้งแต่พื้นฐาน การใช้งานขั้นสูง ไปจนถึงแนวทางปฏิบัติและกรณีศึกษาจริง เพื่อให้คุณพร้อมนำไปประยุกต์ใช้ในงานพัฒนาได้ทันที

ทำความรู้จักกับ NETPIE และ REST API

NETPIE เป็นแพลตฟอร์มคลาวด์สำหรับ IoT ที่พัฒนาขึ้นในประเทศไทย มีจุดเด่นในเรื่องความง่ายในการใช้งาน การรองรับโปรโตคอลมาตรฐานอย่าง MQTT และที่สำคัญคือมีฟรีทีแรร์ที่เอื้อต่อการเริ่มต้นพัฒนา โดย NETPIE ทำหน้าที่เป็น “ตัวกลาง” (Middleware) คอยรับ-ส่งข้อมูลระหว่างอุปกรณ์ IoT (Device) กับแอปพลิเคชันหรือแดชบอร์ด (Application) รวมถึงจัดเก็บข้อมูลและจัดการสถานะของอุปกรณ์

REST API คืออะไร และสำคัญอย่างไรใน NETPIE

REST API (Representational State Transfer Application Programming Interface) คือสถาปัตยกรรมหนึ่งสำหรับการออกแบบเว็บเซอร์วิส ซึ่งใช้ HTTP methods (GET, POST, PUT, DELETE) ในการดำเนินการกับทรัพยากร (Resources) เช่น ข้อมูลอุปกรณ์หรือข้อมูลเซ็นเซอร์

สำหรับ NETPIE แล้ว REST API ทำหน้าที่เป็น “ประตูทางเลือก” นอกเหนือจาก MQTT โดยเฉพาะสำหรับระบบหรือแอปพลิเคชันที่:

• ไม่สะดวกใช้ MQTT Client เช่น เว็บเบราว์เซอร์ฝั่งผู้ใช้ (Front-end JavaScript) หรือแอปมือถือบางสภาพแวดล้อม
• ต้องการดำเนินการแบบ Request/Response เช่น การขอข้อมูลล่าสุดจากอุปกรณ์เฉพาะครั้ง, การสั่งการอุปกรณ์และรอผลตอบกลับทันที
• ต้องการบูรณาการกับระบบเดิม (Legacy System) ที่สื่อสารผ่าน HTTP/REST อยู่แล้ว
• ต้องการดึงหรืออัพเดทข้อมูลจากระยะไกล โดยไม่ต้องรักษาการเชื่อมต่อแบบ Real-time ตลอดเวลา

กล่าวโดยสรุป NETPIE REST API ทำให้การทำงานกับ IoT กลายเป็นเรื่องที่ใกล้เคียงกับการพัฒนาเว็บแอปพลิเคชันทั่วไปมากขึ้น

สถาปัตยกรรมและองค์ประกอบหลัก

การทำงานของ NETPIE REST API เกี่ยวข้องกับองค์ประกอบหลักของแพลตฟอร์ม NETPIE ดังนี้:

• AppID: รหัสประจำตัวแอปพลิเคชันของคุณบน NETPIE (คล้ายกับ Project ID)
• Key & Secret: คีย์ลับสำหรับการยืนยันตัวตน (Authentication) ของอุปกรณ์หรือแอปพลิเคชัน
• Device (Shadow): ตัวแทนของอุปกรณ์จริงบนคลาวด์ NETPIE แต่ละ Device จะมีสถานะ (State) เป็น JSON Object
• REST API Endpoint: URL ปลายทางสำหรับเรียกใช้ API เช่น https://api.netpie.io/v2/device/{deviceid}/shadow
• HTTP Methods: GET (ดึงข้อมูล), PUT (อัพเดท/แทนที่), POST (สร้าง), DELETE (ลบ)

เริ่มต้นใช้งาน NETPIE REST API อย่างละเอียด

ก่อนจะเรียกใช้ API ได้ คุณต้องเตรียมสภาพแวดล้อมและข้อมูลสำหรับการยืนยันตัวตนให้เรียบร้อย

ขั้นตอนที่ 1: สร้างบัญชีและเตรียมความพร้อมบน NETPIE

1. สมัครบัญชีฟรีที่ netpie.io
2. สร้างแอปพลิเคชันใหม่ (New App) เพื่อรับ AppID
3. ภายในแอปพลิเคชัน ให้สร้างอุปกรณ์ (Device) อย่างน้อยหนึ่งตัว หรือสร้าง Key สำหรับแอปพลิเคชัน (App Key)
4. บันทึกค่าที่สำคัญ: AppID, Device ID (หรือ Key name), Key, Secret

ขั้นตอนที่ 2: หลักการ Authentication และการสร้าง Header

NETPIE REST API ใช้การยืนยันตัวตนแบบ “HTTP Basic Authentication” โดยใช้ Key เป็น Username และ Secret เป็น Password ในการสร้าง Authorization Header

// ตัวอย่างการสร้าง Authorization Header ใน JavaScript
const key = 'your-key-here';
const secret = 'your-secret-here';
// นำ Key และ Secret มารวมกันและเข้ารหัส Base64
const token = btoa(`${key}:${secret}`);
const headers = {
    'Authorization': `Basic ${token}`,
    'Content-Type': 'application/json'
};

// ตัวอย่างใน Python
import base64, requests
key = "your-key-here"
secret = "your-secret-here"
token = base64.b64encode(f"{key}:{secret}".encode()).decode()
headers = {'Authorization': f'Basic {token}'}

ขั้นตอนที่ 3: เรียกใช้ API พื้นฐานครั้งแรก (ดึงข้อมูล Shadow)

เรามาลองดึงข้อมูลสถานะ (Shadow) ของอุปกรณ์กัน ซึ่งเป็นจุดเริ่มต้นที่พบบ่อยที่สุด

// ตัวอย่างการใช้ cURL เพื่อดึง Shadow
curl -X GET \
  "https://api.netpie.io/v2/device/{your-device-id}/shadow" \
  -H "Authorization: Basic {your-base64-token}"

// ตัวอย่าง Response (JSON)
{
  "data": {
    "temperature": 28.5,
    "humidity": 65,
    "led": "on"
  },
  "revision": 42,
  "timestamp": "2026-01-15T10:30:00Z"
}

ใน Response จะมีฟิลด์ data ซึ่งคือสถานะปัจจุบันของอุปกรณ์, revision คือเลขรุ่นของข้อมูล (ใช้ตรวจสอบการเปลี่ยนแปลง), และ timestamp คือเวลาที่ข้อมูลถูกอัพเดทล่าสุด

ฟีเจอร์และ Endpoint สำคัญของ NETPIE REST API

NETPIE REST API มี Endpoint ให้ใช้งานครอบคลุมการทำงานหลักๆ เราจะแบ่งออกเป็นหมวดหมู่ดังนี้

1. Device Shadow API

เป็นกลุ่ม API สำหรับจัดการสถานะของอุปกรณ์ (Device Shadow) ซึ่งเป็น JSON Object ที่เก็บค่าต่างๆ ของอุปกรณ์

• GET /v2/device/{deviceid}/shadow: ดึงข้อมูล Shadow ทั้งหมด
• PUT /v2/device/{deviceid}/shadow: อัพเดทหรือแทนที่ข้อมูล Shadow ทั้งหมด
• PATCH /v2/device/{deviceid}/shadow: อัพเดทเฉพาะบางฟิลด์ใน Shadow (แนะนำให้ใช้มากกว่า PUT)
• GET /v2/device/{deviceid}/shadow/data?field=temp: ดึงค่าเฉพาะฟิลด์

// ตัวอย่างการอัพเดทเฉพาะฟิลด์ด้วย PATCH (JavaScript fetch API)
const updateData = {
    "data": {
        "led": "off",
        "fan_speed": 3
    }
};

fetch(`https://api.netpie.io/v2/device/{deviceid}/shadow`, {
    method: 'PATCH',
    headers: headers, // headers จากขั้นตอนก่อนหน้า
    body: JSON.stringify(updateData)
})
.then(response => response.json())
.then(data => console.log('อัพเดทสำเร็จ:', data));

2. Device Message API

ใช้สำหรับส่งข้อความ (Message) ไปยังอุปกรณ์หรือระหว่างอุปกรณ์ โดยอาศัย Topic แบบ MQTT

• POST /v2/device/{deviceid}/message: ส่งข้อความจากอุปกรณ์นี้ไปยัง Topic ใดๆ
• GET /v2/device/{deviceid}/message: ดึงข้อความใน Outbox ของอุปกรณ์ (แบบ polling)

3. Device Information & Management API

ใช้สำหรับจัดการข้อมูลอุปกรณ์และตรวจสอบสถานะ

• GET /v2/device/{deviceid}: ดึงข้อมูลเมตาดาตาของอุปกรณ์ (ชื่อ, ออนไลน์/ออฟไลน์)
• PUT /v2/device/{deviceid}: อัพเดทข้อมูลเมตาดาตาของอุปกรณ์ (เช่น ชื่ออุปกรณ์)

4. App & Group API

สำหรับการจัดการในระดับแอปพลิเคชันหรือกลุ่มอุปกรณ์

• GET /v2/devices: ดึงรายการอุปกรณ์ทั้งหมดในแอปพลิเคชัน
• POST /v2/device: สร้างอุปกรณ์ใหม่ผ่าน API
• GET /v2/groups: ดึงรายการกลุ่ม

การประยุกต์ใช้จริงและกรณีศึกษา (Real-World Use Cases)

เพื่อให้เห็นภาพที่ชัดเจน เรามาดูตัวอย่างการนำ NETPIE REST API ไปใช้ในสถานการณ์จริง

กรณีศึกษา 1: ระบบติดตามและควบคุมสภาพแวดล้อมในโรงเพาะชำอัจฉริยะ

สถานการณ์: ฟาร์มโรงเพาะชำต้องการติดตามอุณหภูมิ ความชื้นในอากาศ และความชื้นในดินจากหลายๆ โซน พร้อมกับสามารถควบคุมระบบรดน้ำและม่านพรางแสงได้จากแอปมือถือ

การออกแบบ:

• อุปกรณ์ในแต่ละโซน (NodeMCU/ESP32) เชื่อมต่อกับเซ็นเซอร์และรีเลย์ ใช้ MQTT อัพเดทข้อมูลขึ้น NETPIE ทุก 1 นาที
• แอปพลิเคชันมือถือ (React Native) ใช้ REST API ในการ:
  1. GET /shadow: ดึงค่าสภาพแวดล้อมล่าสุดทั้งหมดมาแสดงบนแดชบอร์ดเมื่อเปิดแอป
  2. PATCH /shadow: เมื่อผู้ใช้กดปุ่ม “เปิดน้ำ” ในแอป จะส่งคำสั่งอัพเดทฟิลด์ {"water_pump": "on"} ไปยัง Shadow ของอุปกรณ์ในโซนนั้น
  3. อุปกรณ์ที่订阅 Topic ของตัวเองไว้จะได้รับคำสั่งผ่าน MQTT ทันที และดำเนินการเปิดปั๊มน้ำ
• เซิร์ฟเวอร์ส่วนกลางใช้ REST API ในการดึงข้อมูลย้อนหลังเพื่อสร้างรายงานสรุปประจำวัน

กรณีศึกษา 2: ระบบแจ้งเตือนและติดตามสินค้าแบบเรียลไทม์

สถานการณ์: บริษัทโลจิสติกส์ต้องการติดตามตำแหน่งและอุณหภูมิภายในตู้คอนเทนเนอร์ขนส่งสินค้าเปราะบาง

การออกแบบ:

• อุปกรณ์ติดตาม (GPS Tracker + Thermometer) ในตู้คอนเทนเนอร์ส่งข้อมูลผ่านเครือข่าย Cellular ขึ้น NETPIE
• ระบบ Back-office ใช้ REST API ในการ:
  1. เรียกข้อมูลตำแหน่งล่าสุดของตู้คอนเทนเนอร์ทั้งหมด (GET /devices และ GET /shadow ของแต่ละตัว) เพื่อแสดงบนแผนที่
  2. ตั้งค่า Threshold อุณหภูมิผ่าน PATCH /shadow (เช่น {"temp_alert_threshold": 5})
  3. เมื่ออุณหภูมิเกิน阈值 อุปกรณ์จะส่งข้อความแจ้งเตือนผ่าน MQTT มาที่ Topic เฉพาะ
  4. Webhook บนเซิร์ฟเวอร์ใช้ REST API GET /message เพื่อ poll ข้อความแจ้งเตือนนั้นและส่งอีเมล/ไลน์ให้เจ้าหน้าที่

กรณีศึกษา 3: การบูรณาการกับแชทบอท (Line Bot)

สถานการณ์: เจ้าของบ้านต้องการสั่งเปิด-ปิดเครื่องใช้ไฟฟ้าในบ้านผ่าน Line Chat

การออกแบบ:

• สร้าง Line Bot และเชื่อมกับเซิร์ฟเวอร์ (ใช้ Node.js + Express)
• เมื่อผู้ใช้ส่งข้อความ “เปิดไฟหน้าบ้าน” ไปที่ Line Bot:
  1. เซิร์ฟเวอร์ของบอตรับข้อความและประมวลผลคำสั่ง
  2. เซิร์ฟเวอร์เรียก NETPIE REST API (PATCH /shadow) เพื่ออัพเดทสถานะของอุปกรณ์ควบคุมไฟหน้าบ้านเป็น {"front_light": "on"}
  3. อุปกรณ์ได้รับคำสั่งและทำงาน ส่งผลตอบกลับกลับมา
  4. บอตใช้ REST API GET /shadow เพื่อตรวจสอบว่าสถานะเปลี่ยนแล้ว และตอบกลับผู้ใช้ว่า “เปิดไฟหน้าบ้านเรียบร้อยแล้ว”

แนวทางปฏิบัติที่ดีที่สุด (Best Practices) และข้อควรระวัง

เพื่อให้การพัฒนาโปรเจกต์ด้วย NETPIE REST API มีประสิทธิภาพ ปลอดภัย และรักษาได้ง่าย ควรปฏิบัติตามแนวทางเหล่านี้

1. การจัดการคีย์และความปลอดภัย

• อย่าเก็บ Key/Secret ในโค้ดฝั่ง Front-end (เช่น JavaScript) เพราะจะถูกเห็นโดยผู้ใช้ทั้งหมด ให้ใช้ REST API จากฝั่ง Back-end เท่านั้น หรือใช้วิธีสร้าง Token ชั่วคราว
• ใช้ Environment Variables หรือ Secure Vault ในการเก็บคีย์ลับบนเซิร์ฟเวอร์
• สร้าง Key ที่มีสิทธิ์เหมาะสม (Device Scope, App Scope) แทนการใช้ Key เดียวทั้งหมด
• หมุนเวียนเปลี่ยนคีย์ (Key Rotation) เป็นระยะ

2. การออกแบบโครงสร้างข้อมูลใน Shadow

• ออกแบบ JSON structure ใน Shadow ให้เป็นระเบียบและสอดคล้องกับข้อมูลอุปกรณ์จริง
• ใช้การอัพเดทแบบ PATCH แทน PUT เว้นแต่ต้องการแทนที่ทั้งหมดจริงๆ เพื่อป้องกันการลบข้อมูลฟิลด์อื่นโดยไม่ตั้งใจ
• ใช้ฟิลด์ revision ในการตรวจสอบความทันสมัยของข้อมูลก่อนอัพเดท เพื่อป้องกัน Conflict

3. การจัดการข้อผิดพลาดและ Retry Logic

การเรียก REST API ย่อมมีโอกาสล้มเหลวจากปัญหาอินเทอร์เน็ตหรือเซิร์ฟเวอร์ ควรมีกลไกจัดการข้อผิดพลาดเสมอ

// ตัวอย่าง Retry Logic พื้นฐานใน Python
import requests, time

def call_netpie_api_with_retry(url, headers, payload, max_retries=3):
    for attempt in range(max_retries):
        try:
            response = requests.patch(url, headers=headers, json=payload, timeout=10)
            response.raise_for_status()  # ตรวจสอบ HTTP error
            return response.json()
        except requests.exceptions.RequestException as e:
            print(f"Attempt {attempt+1} failed: {e}")
            if attempt < max_retries - 1:
                wait_time = 2 ** attempt  # Exponential backoff
                print(f"Retrying in {wait_time} seconds...")
                time.sleep(wait_time)
            else:
                print("Max retries reached. Giving up.")
                raise

# เรียกใช้ฟังก์ชัน
data = {"data": {"status": "active"}}
result = call_netpie_api_with_retry(api_url, headers, data)

4. การควบคุมอัตราการเรียก API (Rate Limiting)

NETPIE มีการจำกัดอัตราการเรียก API (Rate Limit) ต่อ Key ต่อช่วงเวลา ควร:

• หลีกเลี่ยงการเรียก API ซ้ำๆ ในลูปที่เร็วเกินไป
• สำหรับข้อมูลที่เปลี่ยนแปลงบ่อย แต่ไม่จำเป็นต้อง real-time สุดๆ อาจใช้การ缓存 (Cache) ข้อมูลชั่วคราวบนฝั่งแอป
• ตรวจสอบ HTTP Response Header X-RateLimit-* เพื่อดูโควต้าที่เหลือ

5. การเลือกใช้ระหว่าง REST API และ MQTT

การเข้าใจว่าควรใช้เครื่องมือไหนเมื่อไหร่จะทำให้ระบบมีประสิทธิภาพสูงสุด

เปรียบเทียบ NETPIE กับแพลตฟอร์ม IoT อื่นๆ

เพื่อให้เห็นภาพรวมของตลาดแพลตฟอร์ม IoT เรามาเปรียบเทียบ NETPIE กับคู่แข่งหลักบางรายในมุมมองของ REST API และปัจจัยอื่นๆ

Summary

NETPIE REST API เป็นเครื่องมือที่ทรงคุณค่าและเข้าถึงง่ายสำหรับนักพัฒนา IoT ในประเทศไทย มันทำหน้าที่เป็นสะพานเชื่อมระหว่างโลกของอุปกรณ์ IoT กับแอปพลิเคชันและระบบสารสนเทศแบบดั้งเดิม ผ่านโปรโตคอล HTTP ที่คุ้นเคย ตั้งแต่การดึงและอัพเดทสถานะอุปกรณ์ (Shadow) การส่งข้อความ ไปจนถึงการจัดการอุปกรณ์และกลุ่ม การใช้งานที่มีประสิทธิภาพต้องอาศัยความเข้าใจในหลักการ Authentication การออกแบบโครงสร้างข้อมูลที่ดี การจัดการข้อผิดพลาด และการเลือกใช้ให้เหมาะสมระหว่าง REST API กับ MQTT เมื่อพิจารณาจากการสนับสนุนภาษาไทย ค่าใช้จ่ายเริ่มต้นที่ฟรี และ latency ที่ต่ำภายในประเทศ NETPIE จึงเป็นตัวเลือกชั้นนำสำหรับโครงการ IoT สไตล์ไทยที่ต้องการพัฒนาได้เร็ว มีประสิทธิภาพ และเติบโตได้ในระยะยาว ด้วยความรู้จากคู่มือฉบับสมบูรณ์นี้ คุณจึงพร้อมแล้วที่จะสร้างสรรค์นวัตกรรม IoT ที่เชื่อมต่อทุกสิ่งอย่างมีประสิทธิภาพ