JavaScriptでAPIを呼び出す方法を現役エンジニアが解説【初心者向け】
初心者向けにJavaScriptでAPIを呼び出す方法について解説しています。APIとは外部のサイトやプログラムから関数やメソッドを通してデータを取得出来るような仕組みのことです。データが変更されても同じ名前の関数やメソッドでデータを取得することが出来ます。
テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元：GMOリサーチ株式会社 調査期間：2021年8月12日～8月16日 調査対象：2020年8月以降にプログラミングスクールを受講した18～80歳の男女1,000名 調査手法：インターネット調査
JavaScriptでAPIを呼び出す方法について解説します。
実際のコードをもとに解説していきますので、理解を深めていきましょう。
また、入門向けのJavaSriptを学習できるサイトも紹介しているので、合わせてご覧ください。
そもそもJavaScriptについてよく分からないという方は、JavaScriptとは何なのかについて解説した記事を読むとさらに理解が深まります。
なお本記事は、TechAcademyのオンラインブートキャンプJavaScript/jQuery講座の内容をもとにしています。
今回は、JavaScriptに関する内容だね！
どういう内容でしょうか？
JavaScriptでAPIを呼び出す方法について詳しく説明していくね！
お願いします！
APIとは
APIとはApplication Programming Interface（アプリケーション・プログラミング・インターフェイス）」の略です。
例えば、ある地域の天気の情報をプログラムで取得する方法を考えてみましょう。すべて自分で行おうとしたら、膨大な手間がかかることが想像できます。
- その地域に気象センサーを設置
- 得られた情報をデータ格納用のコンピュータに蓄積
- 雨量や湿度から、晴れや曇りといった天気を判断
- プログラムからデータ格納用のコンピュータにアクセスし、該当する地域の天気の情報を取得
しかし本来行いたいことは「ある地域の天気の情報を取得する」ことです。そこでデータの準備を切り離し、条件を指定するだけで簡単に利用できるようにしたのがAPIです。APIを使うと以下のようになります。
- プログラムから天気の情報を提供するAPIに地域を指定してアクセスし、該当する地域の天気の情報を取得する
簡単ですね。また、このようにAPI経由で情報を取得することで、情報を提供する側の内部の処理やデータの格納方法が変わっても、天気の情報を利用する側には影響が無いといったメリットもあります。
JavaScriptでAPIを呼び出す方法
JavaScriptでAPIを呼び出すには「XMLHttpRequest」を利用します。
// XMLHttpRequestオブジェクトの作成
var request = new XMLHttpRequest();
// URLを開く
request.open('GET', URL, true);
// レスポンスが返ってきた時の処理を記述
request.onload = function () {
// レスポンスが返ってきた時の処理
}
// リクエストをURLに送信
request.send();
実際に書いてみよう
今回のサンプルプログラムでは、APIテスト用のデータを提供しているサイトからデータを取得してログに出力します。ログはChromeであれば、デベロッパーツールのConsoleで確認できます。
https://jsonplaceholder.typicode.com/
<!DOCTYPE html>
<html>
<head>
<script>
var request = new XMLHttpRequest();
request.open('GET', 'https://jsonplaceholder.typicode.com/users/1', true);
request.responseType = 'json';
request.onload = function () {
var data = this.response;
console.log(data);
};
request.send();
</script>
</head>
<body>
</body>
</html>
実行結果は以下のようになります。
筆者プロフィール
| この記事を監修してくれた方
太田和樹（おおたかずき） 普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。 開発実績：画像認識技術を活用した駐車場混雑状況把握（実証実験）、音声認識を活用したヘルプデスク支援システム、Pepperを遠隔操作するアプリの開発、大規模基幹系システムの開発・導入マネジメント 地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。 |
内容分かりやすくて良かったです！
ゆかりちゃんも分からないことがあったら質問してね！
分かりました。ありがとうございます！
TechAcademyでは、初心者でもJavaScript・jQueryを使ったWebサービス公開を習得できるオンラインブートキャンプJavaScript/jQuery講座を開催しています。
挫折しない学習方法を知れる説明動画や、現役エンジニアとのビデオ通話とチャットサポート、学習用カリキュラムを体験できる無料体験も実施しているので、ぜひ参加してみてください。
