API（应用程序编程接口）是一组定义和协议，用于构建和集成应用软件，允许不同的软件系统之间进行通信和数据交换。

在 Hamibot 体系中，API 主要应用于以下两个场景：

1. Hamibot 开放平台 API

用于通过外部程序管理 Hamibot 资源（如脚本、设备、定时任务等），实现与其他系统的集成。

• 访问地址：https://api.hamibot.com/（备用地址 https://api.hamibot.cn/，适用于小程序等场景）
• 身份验证：所有请求需在 HTTP 标头中携带个人访问令牌。

  curl -H "Authorization: hmp_..." https://api.hamibot.com/
  

• 获取令牌：前往控制台生成新令牌：https://hamibot.com/account/tokens
• 速率限制：API 请求受速率限制约束，具体限制参考返回的 HTTP 响应头。

2. 脚本内的 HTTP 模块

允许运行在设备上的脚本通过网络请求与外部服务器交互（如获取配置、上报数据、调用第三方服务）。

• 常用方法：http.get(), http.post(), http.request(), http.postMultipart()
• 代码示例（注意 JavaScript 引擎兼容性）：

  // 文档地址 https://docs.hamibot.com/
  var url = "https://api.hamibot.com/";
  var res = http.get(url);
  
  if (res.statusCode == 200) {
      log(res.body.string());
  } else {
      log("请求失败：" + res.statusCode);
  }
  

使用建议

• 安全性：个人访问令牌等同于密码，请勿泄露或在脚本中硬编码敏感信息。
• 兼容性：脚本内编写 JavaScript 时，避免使用箭头函数、默认参数等 ES6 新特性，确保在 Rhino 1.7.15 引擎下正常运行。
• 错误处理：网络请求可能失败，务必在代码中添加状态码判断和异常捕获逻辑。

通过合理使用 API，你可以构建更灵活的自动化工作流，或将 Hamibot 纳入现有的运维管理体系中。