Puppet Forge API未返回预期JSON，新手查询模块版本遇阻

我最近正试着捣鼓Puppet Forge API，想查模块的最新版本，好和我当前Puppetfile里的版本做对比。但我完全是API访问领域的小白，Forge的文档好像默认我懂很多似的，折腾半天一点进展都没有。

看forgeapi.puppet.com的文档说：这个API通过HTTPS访问，域名是forgeapi.puppetlabs.com，所有数据都是JSON格式返回。可我翻来翻去就是找不到具体怎么调用，连最基础的请求例子都没找到，更别说怎么针对某个模块查最新版本了...

给新手的傻瓜式调用步骤（用curl就行，不用复杂工具） #

• 先搞对模块的完整名称
  Puppet模块的标准格式是用户名/模块名，比如官方的nginx模块是puppet/nginx，这个别写错，不然查不到数据。
• 直接发GET请求查模块详情
  打开终端，用curl命令调用API的v3稳定接口，格式如下：

  curl https://forgeapi.puppetlabs.com/v3/modules/你的模块完整名称
  

  举个实际例子，查puppet/nginx的信息就敲：

  curl https://forgeapi.puppetlabs.com/v3/modules/puppet/nginx
  

• 快速提取最新版本号
  返回的JSON数据里，current_release字段下的version就是该模块的最新版本。如果装了jq工具（专门解析JSON的轻量工具），可以直接提取：

  curl -s https://forgeapi.puppetlabs.com/v3/modules/puppet/nginx | jq '.current_release.version'
  

  要是没装jq，用grep+awk也能临时凑合用：

  curl -s https://forgeapi.puppetlabs.com/v3/modules/puppet/nginx | grep -o '"version":"[^"]*"' | awk -F '"' '{print $4}'
  

和Puppetfile对比的小思路 #

• 你可以写个简单的脚本自动对比版本：先从Puppetfile里提取出mod '用户名/模块名', '版本号'的行，拆分出模块名和本地使用的版本，再循环调用上面的API获取最新版本，最后对比两个版本，输出需要更新的模块清单。

新手容易踩的坑 #

• 必须用HTTPS：域名是forgeapi.puppetlabs.com，别写成HTTP，不然要么被重定向要么直接拒绝访问。
• 公开模块无需认证：查询公开模块的接口不需要API密钥，直接就能调用，这点对小白很友好。
• 认准v3接口：别去尝试旧的v1/v2接口，那些已经废弃了，文档里可能没特意标注。

内容的提问来源于stack exchange，提问作者mothbitten