和 API 的结合是 Workflow 最复杂的功能，大概也是 iOS 里的效率软件目前能够做到的最效率的事，掌握了如何在 Workflow 里使用 API 就可以说这个 App 已经被你征服了。
API 是 Application Programming Interface 的缩写，中文译为应用程序接口，术语解释到此结束，你对这单词有个感觉就行。
普通用户使用 API 的理由不外乎方便，很多时候我们对搜索结果的期待只是一些具体的内容或数值，比如汇率的数值、气温的度数等等，能够直接抓取这些内容对于开发者很重要，但对于我们普通用户来说，如果能够直接获取数值或字符，也省去了每次都打开以及加载网页的时间和流量。
这篇文章以以下三个例子带大家入门 API 以及如何在 Workflow 里使用 API（文章长，如果没耐性，可以只读第二个例子，因为它最详尽）：
在 iOS 上做到一键让 PC 上下载自己 iOS 设备的最新固件 在 iOS 上做到 Search Link 在 iOS 上做到批量保存 Google Image 第一个搜索结果 利用 Transloader 一键下载最新固件这部分内容并没有在 Workflow 里调用 API，主要目的通过做个小玩意儿使你接触这个东西，知道它是什么，减低对它的恐惧。
作为一个 Jailbreaker，跟固件打交道是常有的事，尤其是当越狱突然放出的时候，我会马上更新到最新固件然后越狱。但是，固件发布当时我未必在家，加上固件都不小回家以后要下载很久。所以必须想个办法能够让我在手机上点一下，家里的电脑就会自动下载我的设备的最新版固件。
Workflow 结合 ipsw.me 的 API 再加上 Transloader 可以解决这个问题，只要我知道自己设备的型号，就能够通过 Transloader 在家里的 Mac 上下载最新版的固件，这样回到家以后，新鲜的固件就躺在那里等着我了。
想要用好 API，要养成翻开发者文档的习惯，你或许对「文档」这两个字的理解是枯燥乏味以及晦涩难懂。这是正常的，因为它们不是睡前读物，它们更多的是工具，要做到的是规范和高效，所以它们的用词才会机械，从而也便于搜索和定位。
ipsw.me 的 URL 格式在其 官方文档 里有很明确的表述。
我们想要下载的是自己设备的最新固件，用到的 URL 就是：
http://api.ipsw.me/v2.1/设备的Identifier/latest/url比如说我的 iPhone 6 Plus 的最新固件下载链接的 API 页面，就是：
http://api.ipsw.me/v2.1/iPhone7,1/latest/url打开这个界面，你会看到一串网址：
相信你应该能看出来这串网址就是固件的下载链接。
你可能还不太明白为什么会是这样的结果，我们来看一个关于固件的稍复杂一点的 API 的页面，应该能让你理解地更轻松一些。
这个 页面 列出了所有的固件信息，我们只取其中一个的一部分来看：
这是该页面最顶部的一部分内容，它包含了 Apple TV 2G 这款设备的 7.1.2 版本固件的所有信息。
在图中，首先我们可以看到一个明显的层级关系，分别由不同的大括号所区分。最顶级的只有一个内容：devices。在下一层也就是第二层，我们看到了 Apple TV 2G 的 Identifier：AppleTV2,1，这一层下面有一些内容，最下面的是第三层：firmwares，里面包括了更多的信息。图片里截下来的部分只是 7.1.2 版固件的信息，再往下翻，还有同层级的其它版本固件的信息。
你可以注意到，在这个页面里，信息都是引号冒号引号的格式，冒号前的引号中是类别，冒号后的引号中是具体信息。我们通过 API 要做的，就是在知道左边的类别后获取右边的信息。
图片里我标记了三个箭头，分别在 name（名称）、version（版本）、url（链接） 之前，你可以通过这三项你比较熟悉的对象来增强理解。如果你也越狱，你应该还能看见 signed 这一项，这一项后面如果是 true，就说明可以恢复到这个版本。
想了解 API 的话你以后会经常看到这样的界面，但现在我们是想要下载自己设备的最新版本的固件，那么只需要知道自己设备的 Identifier 就足够了。查看设备 Identifier 首先得知道设备型号，设备型号就在设备的背面印着，看一眼就行了：
图片来自 OSXDaily.com
搞清楚机型以后就可以在这个 页面 对应查询到该设备的 Identifier。
下一步要做的是和 Transloader 这个应用的联动：
整个动作很简单，首先做一个菜单，将自己的设备名和带有 Identifier 的 API 页面的 URL 关联起来，然后下一步是从 API 页面获取下载地址，并复制到剪切板。最后通过 Transloader 的 URL Schemes，可以直接跳转到 Transloader 并开始下载剪切板链接里的内容。
Transloader 的机制是，将下载链接保存到 iCloud，如果 Mac 同样运行着 Transloader 并链接到了网络上，就会直接获取链接开始下载。
Search Link在 iOS 上也做到 Search Link 的效果，自定义的余地比较大。
Brett Terpstra 做过一个名叫 Search Link 的小工具，如果你下载了这个工具，当你选中一串字符——比如 @JailbreakHum——再按下设定好的 Search Link 的快捷键，就能做到把 @JailbreakHum 外面套上中括号，并且在后面加上一个小括号，小括号内是 Google 搜索的第一个结果的链接——[@JailbreakHum](weibo.com/jailbreakhum)。这对用 Markdown 写作的人来说是个很方便的工具，而这个工具核心就是 Google Search 的 API。一旦知道了这个 API，那么在 iOS 就可以通过 Workflow 做到同样的事情。
Google Web Search API 的官方文档 新手没有必要看，我们通过 Workflow 来使用 API，最关键的是找到我们需要的 JSON（新手不需要彻底知道是什么）页面，在 Search Link 这个动作中，我们需要的页面的 URL 是：
https://ajax.googleapis.com/ajax/services/search/web?v=1.0&q=JailbreakHum&rsz=1这就是使用 Google 搜索 JailbreakHum 以后第一个搜索结果的 JSON 页面：
在这个 URL 里，要注意的只有最后那一小段（因为前面的是固定格式）：q= 后面的字符是你要搜索的关键字，而 &rsz=1 则是只获取（第）一个数据的意思，数字可以改，但我们只想获取第一个结果所以在这里要让它是1。
在上面的图片里，也就是这个地址打开后的界面里，你会看到 unescapedUrl:
而在它后面的那个链接，就是在 Google 搜索 JailbreakHum 以后会出现的第一个结果的链接，也就是微博链接：
http://weibo.com/jailbreakhum
如果能够自动获取这个 URL，就能够获取在 Google 上搜索 JailbreakHum 的第一个结果的链接了，同理，你也可以获得你想搜索的任何关键词的第一个结果的链接，这就是 Search Link 的核心。而如果你想给关键字套上中括号，给链接套上小括号，这都是 Workflow 里的基础操作了。
下面我们具体来结合 Workflow 的动作流程看看如何实现这个功能：
第一步：获取/输入关键词，编码，填入 URL
首先，因为 iOS 上目前还没办法直接在选中字符后打开 Sharesheet，所以我用的是通过获取剪切板内容来获取关键词，使用这种办法的好处是可以直接用 Launch Center Pro 或者 Launcher 这样的应用直接激活动作。另外你也可以在这里建一个菜单，设一个 Ask for Input 这样的动作，这样你可以临时输入关键词。
然后说解码，简单来说，URL 里只能填入最基本的字符，其它的都需要编码。要养成一个填入 URL 之前编码的好习惯。
把关键词填入 URL 就是那个 text 文本框做的事，也可以使用 URL 这个动作，但 URL 我一直都不喜欢用，因为不好修改里面的内容。
第二步：获取链接这一步是 Workflow 跟 API 打交道的重要步骤：
首先下载链接内容，也就是获取 JSON 页面。然后从页面中获取词典（不用纠结，只要知道有这一步即可）。
下一步开始一步一步获取 key：先是获取第一层的 key——responsedData 的内容，再获取第二层的 key——results 的内容，最后获取我们想要的 key——unescapedUrl 的内容，也就是 http://weibo.com/jailbreakhum。
每个 key 的引号后面的全部字符都是这个 key 的内容，所以必须一步步精确到我们要的那一层，计算机不会跳步，你直接要 unescapedUrl 它就不知道该怎么办了。
第三步：处理链接获得链接以后，最后一步就是处理这个链接，这一步就简单了：
你可以做个菜单，选择复制到剪切板或是跳转到你常用的文本编辑软件。相信对于读过我之前教程的人都不是难事。有能力的，甚至可以和 Editorial 里的动作进行搭配，在 Editorial 里完全做到 Search Link 也并非不可能。
批量保存 Google Images 的第一个搜索结果同样使用 Google 的 API，但比 Search Link 简单些，可以作为练手。
批量保存图片的情况属于那种不常遇到，但如果遇到的话会很麻烦的事情。在 Google 一张一张地搜索再一张一张的打开原图保存，那酸爽……比如有时候软件测评媒体经常会做这样一种专题图，它要有许许多多的大牌应用图标作为背景，一张一张图搜了下载是个办法、直接从 ipa 文件里获取也是办法，但若论效率的话直接以 应用名icon 输入所有应用的名称然后从 Google Image 获取第一个下载结果应该是更好的办法1。而通过活用 Google Image Search 的 API，可以轻松的在 Workflow 做到这件事。
有了前面 Google Search 的例子，这里的描述会容易很多。首先，我们要找的是那个含有 JSON 页面的 URL：
https://ajax.googleapis.com/ajax/services/search/images?v=1.0&q=关键词&rsz=1然后我们直接结合 Workflow 的动作流程来看看如何在 Search Link 的基础上稍作修改做到直接下载 Google Image 搜索结果的第一张：
第一步：输入关键词
在图中我们看到多了一步 Split Text，这是我们用过多次的将文本转换成列表的功能，使用它是为了在需要批量下载图片的时候方便一些。在 Split Text 里我们看到是用 Space 也就是空格来划开字符，那么当你需要下载多张图片的时候，只需要在不同的关键词之间输入空格即可。（不要忘记编码~）
第二步：填入 URL，获取图片
首先用 Repeat 把动作框起来，这样的话单张多张图片搜索的时候都可以用。
下一步和 Search Link 一样，就是把关键词填入 URL，获取词典，再不断地获取 Key，知道获取了图片的网址。
下一步用下载网址的内容或从网址获取图片都可以，但最后不要忘记把它们存到相机胶卷。当然你也可以改存到其它位置，看个人需求。
小结及补充1. 用 JSON FORMATTER & VALIDATOR 将 JSON 页面变得整洁2。
本文涉及的 API 内容都是 JSON，一般 JSON 的代码看起来是一坨：
想要把这一坨东西按照层级排列起来可以用 JSON FORMATTER & VALIDATOR 这个服务，把代码粘贴进去，整洁的结果就出来了：
2. 其它公共 API 获取的地方
API 分公共 API 和私有 API，公共的可以不用注册专门的账户直接用，私有的则不可以。而 Workflow 能用的也只是部分公共 API 能做到的事情，比较有名的公共 API 库有 ProgrammableWeb, Mashape API, 和 Data.gov3。除此之外，你也可以使用 Apple 的 iTunes Search API 跟 Yahoo 等公司的公共 API 来做有意思的事，比如 Search Link 有直接获取 App 的 iTunes 链接的功能，你可以参考上面的文章来挑战一下这个。另外 @do-fine 就给用 Yahoo Weather 的 API 做了个给女朋友发天气的 Workflow，虽然实用性好像不如 IFTTT，但也是很好的练手方法。
在这里你当然也可以使用 Apple 的 API，我以 Google Image 为例是因为 Google Image 的整体实用范围更广，当然如果你的使用情境更侧重于 iOS 应用，那么可以参看 Apple 的文档，相信你看了这篇文章应该也会使用 Workflow 结合 Apple 的 API 做一些事情了。 ↩︎ 该网站由 @geekdada 分享。↩︎ 来自 Geekwithjuniors。↩︎文章来源 少数派 ，原作者 JailbreakHum ，转载请注明原文链接
原文可获取应用下载链接：Workflow 教程：征服 Workflow 中的最高峰
喜欢少数派？欢迎关注我们的微博：@少数派sspai ，微信公众号： sspaime
少数派（ http://sspai.com ）
