با کلید API خود، از هر زبان یا سرویسی به دادههای مودمهایتان دسترسی داشته باشید.
X-API-Key قرار دهید (یا بهصورت Authorization: Bearer hdp_…).X-API-Key: hdp_xxxxxxxxxxxxxxxxhttps://gateway.nobicode.ir/iot/api/v1/hodhodهمهٔ پاسخها JSON و بهصورت { "success": true, "data": … } هستند. دادهها فقط برای مودمهایی است که به شما تخصیص داده شدهاند.
https://gateway.nobicode.ir/iot/api/v1/hodhod/my-terminalsفهرست مودمهایی که به حساب شما تخصیص داده شدهاند، همراه با تعداد پیام و آخرین زمان ارسال.
نمونه درخواست
curl "https://gateway.nobicode.ir/iot/api/v1/hodhod/my-terminals" \
-H "X-API-Key: hdp_xxxxxxxxxxxxxxxx"نمونه پاسخ
{
"success": true,
"data": [
{
"id": 2,
"terminal_id": "17577",
"name": null,
"lat": 35.728,
"lon": 51.424,
"altitude": 1200.0,
"message_count": 21,
"first_seen_at": "2026-10-06T12:36:28+00:00",
"last_message_at": "2026-10-07T08:07:59+00:00"
}
]
}https://gateway.nobicode.ir/iot/api/v1/hodhod/terminals/{terminal_id}/messagesدریافت پکتهای (پیامهای) ارسالی یک مودم مشخص، بهصورت صفحهبندیشده. با پارامتر q میتوانید در محتوا جستجو کنید.
نمونه درخواست
curl "https://gateway.nobicode.ir/iot/api/v1/hodhod/terminals/17577/messages?page=1&page_size=20" \
-H "X-API-Key: hdp_xxxxxxxxxxxxxxxx"نمونه پاسخ
{
"success": true,
"data": [
{
"id": 4918,
"source_id": "17577_20261007160759_830",
"terminal_id": "17577",
"content": "test",
"raw_content": "74657374",
"frame_crc": 0,
"frame_crc_name": "通过",
"push_status": 11,
"message_time": "2026-10-07T08:07:59+00:00"
}
],
"pagination": { "page": 1, "page_size": 20, "total": 21, "total_pages": 2 }
}https://gateway.nobicode.ir/iot/api/v1/hodhod/stats?period=30dآمار کلی پیامهای شما در یک بازهٔ زمانی (۷d، ۳۰d، ۹۰d یا all).
نمونه درخواست
curl "https://gateway.nobicode.ir/iot/api/v1/hodhod/stats?period=30d" \
-H "X-API-Key: hdp_xxxxxxxxxxxxxxxx"نمونه پاسخ
{
"success": true,
"data": {
"total_messages": 16,
"today_messages": 16,
"active_terminals": 2,
"total_terminals": 2,
"crc_pass_rate": 100.0
}
}نکته: زمانها بهصورت UTC برگردانده میشوند (ISO‑8601) و کلاینت آنها را به زمان محلی تبدیل میکند.