JavaScriptでAPIを呼び出す方法を現役エンジニアが解説【初心者向け】

初心者向けにJavaScriptでAPIを呼び出す方法について解説しています。APIとは外部のサイトやプログラムから関数やメソッドを通してデータを取得出来るような仕組みのことです。データが変更されても同じ名前の関数やメソッドでデータを取得することが出来ます。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営する教育×テクノロジーのWebメディアです。初心者でもすぐ勉強できる記事が2,000以上あります。

JavaScriptでAPIを呼び出す方法について解説します。

実際のコードをもとに解説していきますので、理解を深めていきましょう。

また、入門向けのJavaSriptを学習できるサイトも紹介しているので、合わせてご覧ください。

 

なお本記事は、オンラインブートキャンプ フロントエンドコース(JavaScript・jQuery講座)の内容をもとにしています。

 

 

田島悠介

今回は、JavaScriptに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

JavaScriptでAPIを呼び出す方法について詳しく説明していくね!

大石ゆかり

お願いします!

 

APIとは

APIとはApplication Programming Interface(アプリケーション・プログラミング・インターフェイス)」の略です。

例えば、ある地域の天気の情報をプログラムで取得する方法を考えてみましょう。すべて自分で行おうとしたら、膨大な手間がかかることが想像できます。

  1. その地域に気象センサーを設置
  2. 得られた情報をデータ格納用のコンピュータに蓄積
  3. 雨量や湿度から、晴れや曇りといった天気を判断
  4. プログラムからデータ格納用のコンピュータにアクセスし、該当する地域の天気の情報を取得

しかし本来行いたいことは「ある地域の天気の情報を取得する」ことです。そこでデータの準備を切り離し、条件を指定するだけで簡単に利用できるようにしたのがAPIです。APIを使うと以下のようになります。

  1. プログラムから天気の情報を提供するAPIに地域を指定してアクセスし、該当する地域の天気の情報を取得する

簡単ですね。また、このようにAPI経由で情報を取得することで、情報を提供する側の内部の処理やデータの格納方法が変わっても、天気の情報を利用する側には影響が無いといったメリットもあります。

 

JavaScriptでAPIを呼び出す方法

JavaScriptでAPIを呼び出すには「XMLHttpRequest」を利用します。

// XMLHttpRequestオブジェクトの作成
var request = new XMLHttpRequest();

// URLを開く
request.open('GET', URL, true);

// レスポンスが返ってきた時の処理を記述 
request.onload = function () {
  // レスポンスが返ってきた時の処理
}

// リクエストをURLに送信
request.send();

 

[PR] JavaScript・jQueryで挫折しない学習方法を動画で公開中

実際に書いてみよう

今回のサンプルプログラムでは、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>

実行結果は以下のようになります。

 

筆者プロフィール

この記事を監修してくれた方

太田和樹(おおたかずき)
ITベンチャー企業のPM兼エンジニア

普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。

開発実績:画像認識技術を活用した駐車場混雑状況把握(実証実験)、音声認識を活用したヘルプデスク支援システム、Pepperを遠隔操作するアプリの開発、大規模基幹系システムの開発・導入マネジメント

地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

 

また、TechAcademyではJavaScriptを使ってWebサービスを公開できるオンラインブートキャンプ フロントエンドコース(JavaScript・jQuery講座)を開催しています。

プログラミングの初心者でも受講可能です。Webサイトの表現の幅を広げたいという方はぜひご覧ください。

また、現役エンジニアから学べる無料のプログラミング体験会も実施しているので、ぜひ参加してみてください。