API 概覽
三種整合方式，滿足不同場景需求
v1.0
REST API
完整的 RESTful API，支援設備管理、交易查詢、會員操作。提供 OpenAPI 3.0 規範文件。
即時
Webhook 事件
即時事件推送：付款完成、機台狀態變更、故障告警、會員行為。支援自訂 endpoint。
IoT
MQTT SDK
IoT 設備通訊 SDK，支援 Python / Node.js / C++。即時雙向通訊，低延遲高可靠。
技術架構
雲原生微服務架構，高可用、可擴展
用戶端
LINE LIFF / Web App
API Gateway
驗證 / 限流 / 路由
微服務叢集
付款服務
LINE Pay / Apple Pay / 街口
設備服務
MQTT IoT 控制器
通知服務
LINE Messaging API
數據服務
PostgreSQL + Redis
快速上手
幾行程式碼即可查詢機台狀態
example.py
import requests
# 查詢機台狀態
response = requests.get(
"https://api.cloudmonster.tw/v1/machines",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
machines = response.json()
for m in machines:
print(f"{m['name']}: {m['status']}")