SuperAPI AI 工具集

godaddy-cli

部署与运维

查看项目

更新于 10-15 21:53

技能介绍

用途:godaddy CLI 用于在 GoDaddy 开发者平台上管理应用、认证、环境、部署、扩展和 Webhook。它是 agent-first 工具,所有命令只向 stdout 输出一个 JSON 信封(换行结尾),没有纯文本模式、--json 标志或表格输出,调试信息只写到 stderr。

主要能力:

  • 发现命令:不带参数运行 godaddy 返回完整命令树、当前环境与认证状态;各子命令组(application、auth、env、actions、webhook)不接子命令时显示各自命令树。
  • 认证:OAuth 2.0 PKCE 流程,godaddy auth login 打开浏览器,令牌保存在操作系统钥匙串;用 auth status 检查,auth logout 清除凭据。
  • 环境:ote(测试,默认)与 prod 两个环境,通过 env get / set / list / info 管理,也可用 --env 或 -e 单次覆盖。
  • 应用生命周期:application list / info / validate / init / update / enable / disable / archive。
  • 配置:通过 application add action、add subscription、add extension 向 godaddy.toml 添加动作、订阅与扩展。
  • 发布与部署:application release(部署前必需)与 application deploy,可加 --follow 以 NDJSON 流式输出进度;流中最后一行必为 result 或 error 信封。
  • API 发现与调用:godaddy api list / describe / search / call,支持 -X、-f、-F、-H、-q、-i、-s 等选项。
  • 动作合约:godaddy actions list / describe,仅供开发者发现可作为提供方集成的动作钩子合约,不用于通用 API 端点发现。
  • Webhook:godaddy webhook events 列出事件类型,内联最多 50 条,完整列表(190+)在 full_output 文件路径。

使用方式:成功信封含 ok、command、result、next_actions;失败信封含 ok、command、error(message、code)及 fix。先检查 ok,再读 error.code 做程序化处理。错误码包括 NOT_FOUND、AUTH_REQUIRED、VALIDATION_ERROR、NETWORK_ERROR、CONFIG_ERROR、SECURITY_BLOCKED、COMMAND_NOT_FOUND、UNSUPPORTED_OPTION、UNEXPECTED_ERROR。next_actions 为 HATEOAS 数组,无 params 时按字面执行,有 params 时按模板填空,含 value、default、enum、required 等字段。大结果会自动截断,用 truncated 与 full_output 判断并读取完整数据。

全局选项:--pretty 美化 JSON;--env <env> 或 -e 覆盖环境;--verbose 或 -v 记录 HTTP;--debug 或 -vv 完整详细输出;可出现在命令任意位置,不影响 JSON 结构。

限制:官方资料未提供收费、价格或平台可用性信息;--follow 目前仅用于 deploy;api list 等大结果可能截断;地址类任务应先用 godaddy api search address、godaddy api list --domain location、godaddy api describe /location/addresses,而不是用 actions describe 做通用端点发现。