![](https://help.apple.com/assets/5E8CEA35094622DF10489984/5E8CEA42094622DF1048998D/ja_JP/c10e8a839dc838a25d0feb0e9e428a0a.png)
「ショートカット」で最初のAPIをリクエストする
最初のAPIをリクエストするため、通信先にしたいAPI「エンドポイント」を指すURLを作成してから、そのURLを「URLの内容を取得」アクションに渡します。ショートカットを実行すると、このアクションがAPIリクエストを実行します。
![Dark Sky APIリクエスト。秘密APIキーを指定した「テキスト」アクション、その次に「秘密キー」変数を使用してAPIエンドポイントを指している「URL」アクション、その後に「URLの内容を取得」アクションが含まれています。](https://help.apple.com/assets/5E8CEA35094622DF10489984/5E8CEA42094622DF1048998D/ja_JP/423e77dd905a21932400e2a360003b65.png)
APIリクエストを構築する
Dark SkyのForecastエンドポイントでは、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でエンコードされています。JSONはJavaScript Object Notationの意味です。
JSONの詳しい操作方法について、およびDark Sky APIの例を使い続ける方法については、「ショートカット」でのJSON使用の概要を参照してください。