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