{ "info": { "_postman_id": "dialysis-iot-api-collection", "name": "透析机IoT数据服务 API", "description": "透析机设备实时数据查询和管理接口集合", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "系统管理", "item": [ { "name": "健康检查", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/health", "host": ["{{base_url}}"], "path": ["api", "health"] }, "description": "检查服务器是否正常运行" }, "response": [] } ] }, { "name": "设备数据查询", "item": [ { "name": "获取单个设备数据(原始格式)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/device/data?deviceNumber=D001", "host": ["{{base_url}}"], "path": ["api", "device", "data"], "query": [ { "key": "deviceNumber", "value": "D001" } ] }, "description": "获取指定设备的原始格式数据" }, "response": [] }, { "name": "获取单个设备数据(映射格式)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/device/data?deviceNumber=D001&mapped=true", "host": ["{{base_url}}"], "path": ["api", "device", "data"], "query": [ { "key": "deviceNumber", "value": "D001" }, { "key": "mapped", "value": "true" } ] }, "description": "获取指定设备的映射格式数据(推荐使用)" }, "response": [] }, { "name": "获取所有设备数据(映射格式)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/device/all?mapped=true", "host": ["{{base_url}}"], "path": ["api", "device", "all"], "query": [ { "key": "mapped", "value": "true" } ] }, "description": "批量获取所有设备的映射格式数据" }, "response": [] }, { "name": "获取设备列表", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/device/list", "host": ["{{base_url}}"], "path": ["api", "device", "list"] }, "description": "获取所有已连接设备的摘要信息" }, "response": [] }, { "name": "获取超时设备", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/device/idle?timeout=300000", "host": ["{{base_url}}"], "path": ["api", "device", "idle"], "query": [ { "key": "timeout", "value": "300000", "description": "超时时间(毫秒),默认300000(5分钟)" } ] }, "description": "获取超过指定时间未更新的设备列表" }, "response": [] } ] }, { "name": "统计信息", "item": [ { "name": "获取缓存统计", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/cache/stats", "host": ["{{base_url}}"], "path": ["api", "cache", "stats"] }, "description": "获取数据缓存的统计信息" }, "response": [] }, { "name": "获取限流统计", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/ratelimit/stats", "host": ["{{base_url}}"], "path": ["api", "ratelimit", "stats"] }, "description": "获取请求限流的统计信息" }, "response": [] } ] }, { "name": "缓存管理", "item": [ { "name": "清空缓存", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/cache/clear", "host": ["{{base_url}}"], "path": ["api", "cache", "clear"] }, "description": "清空所有缓存的设备数据(需谨慎使用)" }, "response": [] }, { "name": "清空限流记录", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/ratelimit/clear", "host": ["{{base_url}}"], "path": ["api", "ratelimit", "clear"] }, "description": "清空所有限流记录" }, "response": [] } ] } ], "variable": [ { "key": "base_url", "value": "http://localhost:8080", "type": "string", "description": "API服务器基础地址" } ] }