普渡云 API

解决什么问题

在对接 Pudu 机器人开放接口时，工程师通常要同时处理凭证、集群、path 前缀、参数结构和响应判定。若这些信息分散在文档、脚本和日志中，容易出现 401、403、404 或看似 HTTP 成功但业务失败的情况。

技能如何工作

• 凭证检查：优先读取 PUDU_API_APP_KEY 与 PUDU_API_APP_SECRET，缺失时提示补充；对 ApiAppSecret 做脱敏处理，避免回显完整值。
• 集群确认：根据 PUDU_API_CLUSTER 映射 cn、sea、de、us 到对应 hostname；未明确时要求用户选择，不默认使用 cn。
• 接口定位：按意图读取 assets/*.json 规范文件，覆盖机器人状态、配送、跑腿、顶升托盘、巡航引导、呼叫、闪电匣、媒体内容、控制上报和统计分析等场景。
• 请求执行：优先使用 pudu-request.js，环境受限时降级到 Python、Go、Java、C# 脚本；path 需包含 /pudu-entry 或 /data-board 等规范前缀。
• 结果展示：仅当 HTTP 200 且 message === "SUCCESS" 时判定成功，否则输出错误码与处理建议。

适用边界

该技能适合已经具备 Pudu 开放平台凭证、希望快速调用 Open API 的开发者。它不替代接口权限开通，也不应靠自然语言猜测参数；sn、shopId、cluster 和接口版本都需要按规范文件确认。