プログラミング学習 公開 2026.10.03 更新 2026.11.08

APIとは?初心者向けにJSONの取得とFailed to fetchの原因を動かして解説

執筆・監修: 徐 聖博/株式会社シンシア 代表取締役社長

APIとは?初心者向けにJSONの取得とFailed to fetchの原因を動かして解説

APIはプログラム同士がJSONをやり取りする窓口です。求人検索の件数APIをNetworkタブで確かめ、JSONを取得するページを作ります。Failed to fetchの意味と原因の見分け方、404でも失敗にならないfetchの確かめ方も解説。

APIとは?初心者向けに、JSONの取得と「失敗したとき」を動かして解説

APIは、プログラム同士がデータをやり取りするための窓口です。人間はWebページを見ますが、プログラムは決まった形のデータ(多くは JSON)を受け取ります。

この記事では、まず実在するサービスの画面の裏で、APIがどう呼ばれているかを自分の目で確かめます。題材はナミノリの求人検索です。そのあと、自分のパソコンの中だけで動く小さなページを作り、JSONを取得して表示します。

ただ、この記事でいちばん時間を割くのは、取得に失敗したときの書き方です。よく見かける Failed to fetch というエラーの意味と、原因の見分け方も扱います。書き方を説明するために自分たちのコードを読み直したら、ナミノリにもその処理が抜けていました。

ナミノリの求人検索の裏で動いているAPI

ナミノリの求人一覧には、条件を選ぶと「該当する求人の件数」を表示する仕組みがあります。スマートフォンの幅で表示しているとき、条件のチェックを変えるたびに、ページ全体を読み込み直さずに件数だけを取りに行きます。

このとき呼ばれているのは、次のURLです。

/jobs?(選んだ条件)&count_only=true

返ってくるのはWebページ(HTML)ではなく、次のようなJSONです。

{"count": 9}

「条件に合う求人は9件」という答えだけを、プログラムが読める形で返しています。これがAPIです。画面に出ている件数は、ブラウザのJavaScriptがこのJSONから count の値を取り出して書き込んだものです。

自分の画面で確かめる

  1. Chromeで求人一覧を開く
  2. 右クリック →「検証」で検証画面を開き、左上のスマートフォンの形のアイコン(デバイスモード)を押して、幅を狭くする
  3. 上のタブから「Network」を選び、その下の「Fetch/XHR」を押す(APIの通信だけに絞り込める)
  4. ページの絞り込み条件のチェックを1つ変える

Networkに jobs?...count_only=true という行が増えます。クリックして「Response(レスポンス)」タブを開くと、{"count": ...} が見えます。数字は、その時点の求人の件数によって変わります。

失敗したときの処理が無かった

この記事を書くために、件数を取りに行くナミノリのコードを読み直しました。書かれていたのは、ほぼ次の形です。

fetch(url)
  .then((response) => response.json())
  .then((data) => {
    countElement.textContent = data.count;
  });

成功したときの処理しか書かれていません。サーバーがエラーを返したり、通信が切れたりしたときに何をするかが無いため、前に表示していた件数が、黙ってそのまま残ります。条件を変えたのに数字が変わらず、それが正しい件数なのか、取得に失敗したのか、画面からは区別できません。

2026年10月3日に、失敗したら件数を「-」と表示するように直しました。直し方は、この記事の後半で練習するものと同じです。

ナミノリの「Web初級講座」で「Ajax通信とAPI」の回を受けた社外の受講者33人は、全員が完了し、2回以上かかったのは4人でした。講座の中でも止まりにくい回です。APIの考え方は、それほど難しくありません。抜けやすいのは、失敗したときにどうするかを書くことのほうです。

※ 受講者数は社内の確認用アカウントを除いて集計しました。集計は2026年10月3日。

練習の準備:ファイルを2つ作る

ここからは自分のパソコンで練習します。外部のサービスや、APIを使うための鍵(APIキー)は使いません。同じフォルダに置いたJSONファイルを、APIの代わりに読み込みます。

新しいフォルダ(例:api-practice)を作り、次の2つのファイルを保存してください。

courses.json

{
  "courses": [
    { "title": "Web初級講座", "lectures": 8 },
    { "title": "UNIX初級講座", "lectures": 7 },
    { "title": "JavaScript初級講座", "lectures": 15 }
  ]
}

index.html

<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>APIの練習</title>
</head>
<body>
  <button id="load">講座の一覧を読み込む</button>
  <p id="status"></p>
  <ul id="list"></ul>

  <script>
    const button = document.querySelector("#load");
    const statusText = document.querySelector("#status");
    const list = document.querySelector("#list");

    async function loadCourses() {
      button.disabled = true;
      statusText.textContent = "読み込み中…";
      list.textContent = "";

      try {
        const response = await fetch("courses.json");
        if (!response.ok) {
          throw new Error(`サーバーがエラーを返しました(${response.status})`);
        }

        const data = await response.json();
        if (!Array.isArray(data.courses)) {
          throw new Error("データの形が想定と違います");
        }

        for (const course of data.courses) {
          const item = document.createElement("li");
          item.textContent = `${course.title}(全${course.lectures}回)`;
          list.append(item);
        }
        statusText.textContent = `${data.courses.length}件を読み込みました`;
      } catch (error) {
        statusText.textContent = `読み込めませんでした:${error.message}`;
      } finally {
        button.disabled = false;
      }
    }

    button.addEventListener("click", loadCourses);
  </script>
</body>
</html>

ページは「サーバー」経由で開く

index.html をダブルクリックして開くと、ボタンを押しても 読み込めませんでした:Failed to fetch と表示されます。ブラウザは、ファイルを直接開いたページ(アドレスが file:// で始まる)からの fetch を、安全のために止めるからです。

練習用の小さなサーバーを起動して開きます。Mac・Linux・WindowsのWSLなら、api-practice フォルダで次を実行します(Python 3 が必要です)。

python3 -m http.server 8000

ブラウザで http://localhost:8000/ を開き、ボタンを押してください。

3件を読み込みました
・Web初級講座(全8回)
・UNIX初級講座(全7回)
・JavaScript初級講座(全15回)

と表示されれば成功です。終わったら、ターミナルで Ctrl + C を押すとサーバーが止まります。

コードの読み方:成功までに4つの確認がある

行 していること 無いとどうなるか
await fetch("courses.json") 頼んで、返事(レスポンス)を待つ —
if (!response.ok) 返事が「成功」かを確かめる 404や500でも、中身を読もうとして先に進む
await response.json() 中身をJSONとして読む —
Array.isArray(data.courses) 欲しいデータが想定どおりの形かを確かめる 形が違うと、意味の分からないエラーになる
catch (error) どこかで失敗したら、理由を画面に出す 何も表示されず、利用者には止まったように見える
finally 成功でも失敗でも、最後に必ずボタンを押せる状態に戻す 失敗のあと、もう一度押せなくなる

特に大事なのは2行目の response.ok です。fetch は、サーバーが404や500を返しても「失敗」になりません。 返事が届いた時点で成功扱いになり、catch には進みません。返事の中身が成功かどうかは、自分で response.ok(ステータスコードが200番台か)を確かめる必要があります。ナミノリのコードに抜けていたのも、この確認でした。

表示に textContent を使っているのも意味があります。受け取ったデータに <script> のような文字が入っていても、HTMLとして実行されず、文字のまま表示されます。

わざと失敗させてみる

1か所ずつ壊して、表示が変わることを確かめます。1つ試したら元に戻してください。

壊し方 画面の表示
fetch("courses.json") を fetch("course.json") にする(ファイルが無い) 読み込めませんでした:サーバーがエラーを返しました(404)
courses.json の最後の } を消す(JSONが壊れている) 読み込めませんでした:(JSONとして読めない、という英語のメッセージ)
courses.json の "courses" を "items" にする(形が違う) 読み込めませんでした:データの形が想定と違います
サーバーを止めてからボタンを押す(通信できない) 読み込めませんでした:Failed to fetch

どの失敗でもボタンは押せる状態に戻るので、直してからもう一度押せば読み込めます。これが再試行です。

response.ok の確認を消して1つ目を試すと、違いが分かります。404のページ(HTML)をJSONとして読もうとして、Unexpected token '<' ... is not valid JSON という、2つ目と同じ種類の「JSONとして読めない」メッセージになります。原因はファイル名の間違いなのに、表示からはJSONが壊れているように見えてしまいます。

「Failed to fetch」の意味と、原因の見分け方

Failed to fetch は「フェイルド・トゥ・フェッチ」と読み、「取得に失敗した」という意味です。サーバーから返事(レスポンス)が1つも届かなかったときに、fetch が出すエラーです。上の練習で、ファイルを直接開いたときやサーバーを止めたときに出たのがこれです。

404や500は「返事が届いた」ので Failed to fetch にはならず、response.ok で確かめる必要がありました。Failed to fetch はその逆で、返事が届いていないので catch に進みます。

ブラウザ 表示
Chrome・Edge TypeError: Failed to fetch
Firefox TypeError: NetworkError when attempting to fetch resource.
Safari TypeError: Load failed

(Chromeの表示はこの記事の練習で確かめたもの。FirefoxとSafariはエラー監視サービスTrackJSの解説によります)

困るのは、このエラーの文だけではなぜ届かなかったのかが分からないことです。JavaScriptの側には理由が渡されません。理由はConsoleのほかの行と、Networkタブに出ます。

原因 Console・Networkに出るもの 直し方
サーバーが止まっている、URLのホスト名が違う、ネットにつながっていない Networkの状態が (failed)。Consoleに net::ERR_CONNECTION_REFUSED などが出る サーバーを起動する。URLを見直す
ページを file:// で直接開いている Consoleに blocked by CORS policy の行が出る 練習のように python3 -m http.server などのサーバー経由で開く
別のサイトのAPIで、相手がCORSを許可していない Consoleに has been blocked by CORS policy の行が出る 相手のサーバーの設定で許可してもらう(下のFAQ)
https:// のページから http:// のAPIを呼んでいる Consoleに Mixed Content の行が出る APIも https:// で呼ぶ
広告ブロックなどの拡張機能が止めている Consoleに net::ERR_BLOCKED_BY_CLIENT が出る シークレットウィンドウ(拡張機能なし)で試して切り分ける

手順はいつも同じです。Failed to fetch が出たら、その上下にある赤い行をConsoleで読み、Networkタブで失敗した行の状態を見る。エラーの文で検索するより、早く原因にたどり着けます。

利用者の画面には、練習のコードのように「読み込めませんでした」と出し、もう一度押せる状態に戻しておきます。ナミノリの件数表示を直したときも、この形にしました。

よくある質問

APIとAjaxの違いは?

APIは「データを受け渡す窓口」そのもので、Ajaxは「ページを読み込み直さずに、JavaScriptで裏側から通信する」やり方のことです。ナミノリの件数表示は、Ajaxというやり方で、件数を返すAPIを呼んでいます。

外部のサービスのAPIを使うときも同じですか?

確かめることは同じです。加えて、多くのサービスでは利用登録とAPIキーが必要になり、1日に呼べる回数に上限があります。APIキーはパスワードと同じで、HTMLやJavaScriptに書いて公開したり、Gitに記録したりしてはいけません。

「Failed to fetch」はどういう意味ですか?

「取得に失敗した」という意味で、サーバーから返事が届かなかったことを表します。サーバーの停止、URLの間違い、CORS、https のページから http を呼んでいる、拡張機能が止めている、のどれかであることが多く、どれかはConsoleのほかの行とNetworkタブで分かります。

「CORS」のエラーが出ました。no-cors を付ければ直りますか?

直りません。CORSは、別のサイトのデータを勝手に読めないようにするブラウザの仕組みです。mode: "no-cors" を付けるとエラーは出なくなりますが、中身を読めない返事が返ってくるだけで、データは使えません。CORSは、データを返す側(サーバー)の設定で許可してもらうものです。この記事の練習では、ページとJSONが同じサーバーにあるので、CORSは関係しません。

この練習で、本格的なAPIを作ったことになりますか?

なりません。この記事でしたのは、置いてあるJSONファイルを読み込む側の練習です。本格的なAPIは、サーバー側のプログラムがデータベースを検索するなどして、毎回JSONを作って返します。ナミノリの件数APIもそうです。APIを作る側の考え方は、下の講座で扱っています。

まとめ

  • APIは、プログラム同士がデータ(多くはJSON)をやり取りする窓口
  • ナミノリの求人検索も、件数だけを返すAPIを裏で呼んでいる。Networkタブの「Fetch/XHR」で見える
  • fetch は404や500でも失敗にならない。response.ok を自分で確かめる
  • Failed to fetch は返事が届かなかったときのエラー。理由はConsoleのほかの行とNetworkタブで見る
  • 受け取ったデータの形を確かめ、失敗したら catch で理由を出し、finally で再試行できる状態に戻す
  • ナミノリの件数表示にも失敗時の処理が無く、2026年10月3日に直した

APIを作る側の考え方(どんなURLにするか、エラーをどう返すか)は、API設計入門講座(全5回・無料)で学べます。通信の基本から確かめたい人は、Webの仕組みの記事とWeb初級講座(4回目が「Ajax通信とAPI」)から始めてください。JavaScriptの書き方が不安なら、JavaScript入門に戻るのがおすすめです。

参考資料

この記事をシェア

無料の学習講座で、いまから手を動かす

AI開発からWeb開発まで、未経験でも進められる講座を無料で公開しています。

会員登録(無料) すると、気になる求人の保存と講座の受講履歴の記録ができます。

この順番で合っているか、確認しませんか

学習の順番は、目指す職種によって変わります。いま考えている進め方を書いて送ってもらえれば、無料講座の内容と実際の求人要件に照らして返答します。

相談を書いて送る(無料・会員登録なし)

返答までお時間をいただくことがあります。

新着記事

エンジニアの職種

スクラムマスターとは?役割とプロダクトオーナーとの違い

スクラムマスターの役割を、2020年版スクラムガイドの原文で確かめた2つの責任と3つの支援先から解説。プロダクトオーナー・開発者・PMとの違い、ガイドに書かれていない誤解、ナミノリの求人84件で見た実態もまとめました。

IT資格

応用情報技術者試験の勉強方法|合格率24.5%・CBTと最後の後期

応用情報技術者試験の勉強方法を、IPAの公式発表(令和7年度秋期の合格率24.5%)と、2026年度からのCBT化・2027年度の制度見直しの予定とあわせて解説。科目Aの60点と科目Bの選び方、無料講座の例題も載せています。

IT資格

PSM1の勉強方法は?日本語受験と合格ライン85%の対策

PSM I(Professional Scrum Master I)の勉強方法を、2026年11月に公式で確かめた形式(80問・60分・85%・200米ドル・日本語可)と2020年版スクラムガイドの変更点から解説。無料講座の例題3問つき。

IT資格

ISO42001内部監査員研修とは?27001との違いと統合監査の要点

ISO/IEC 42001の内部監査員研修に共通の試験はありません。研修の日数と修了条件の幅、箇条4〜10と附属書Aの38の管理策、27001との違いと統合監査、国内の認証14件という現状、無料講座の例題3問を解説します。