在“快捷指令”中提出第一个 API 请求
若要提出第一个 API 请求,请创建指向要对话的 API “端点”的 URL,然后将 URL 传递给“获取 URL 内容”操作。快捷指令运行时,此操作会提出 API 请求。
构建 API 请求
“Dark Sky 天气”端点需要按以下方式格式化的 URL 请求:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
中括号内的文本会以 API 密钥和请求天气数据的位置填充。
在“快捷指令”应用中,将 Dark Sky 的 API 密钥放入第一个“文本”操作,此密钥会作为变量传递到 URL 操作中。
LAT
值和LONG
值已设为37.8267
和-122.4233
,这是旧金山恶魔岛的坐标。(您可以将这些值更改为不同位置的坐标)。尝试在 URL 操作中设定魔法变量“纬度”和“经度”,使用“获取当前位置”操作并将其作为魔法变量,这样无论您在哪里运行快捷指令,都能获取本地的天气数据。
搭配“获取 URL 内容”操作执行 API 请求
在“快捷指令”应用的快捷指令编辑器中,将“获取 URL 内容”设为“高级”。
您可将以下 API 请求类型选项变为可用:
GET
允许您从 API 取回数据以阅读。POST
允许您创建新数据。PUT
和PATCH
分别允许您通过替换或修改数据来更新数据。DELETE
允许您移除 URL 请求中指定的对象。
此示例中使用
GET
请求从 Dark Sky API 中取回数据。现在 URL 操作中已包含您的请求,且“获取 URL 内容”操作已设为
GET
数据,您已经准备好提出 API 请求了。【注】当“获取 URL 内容”操作切换到
POST
、PUT
或PATCH
时,会添加一个叫做“请求体”的新参数。“请求体”允许您将 JSON、表单或文件作为请求的一部分发送到 API。此操作可让您手动或使用变量输入新数据,然后就可以将数据发送到 API 以创建、替换或修改条目。轻点 以测试快捷指令(快捷指令中的“快速查看”操作允许您预览 API 返回的数据)。
恭喜,您已经使用“快捷指令”提出了第一个 API 请求。
一眼看去,API 似乎返回了大量格式奇怪的文本。仔细研究一下,您就可以看到文本中包含了天气预报信息。此天气数据以 JSON(代表 JavaScript Object Notation)编码。
若要了解使用 JSON 的信息以及继续了解 Dark Sky API 示例,请参阅 关于在“快捷指令”中使用 JSON。