IT図鑑

無料HTML教材 · 全16章

自宅のPCで学ぶ
はじめてのAPI入門

ブラウザとコマンドで商品データを取得してみよう。Windows 10/11・Mac対応、インストール・登録不要。既存PDFの16ページを章ごとに収録しています。

印刷画面で「PDFに保存」を選択。A4・白背景で出力します。
CHAPTER 01 / 16

APIって何?

ブラウザとコマンドで、商品データを取得してみよう

自分のPC→ GET →商品API→ JSON →自分のPC

理解する

この教材で学ぶこと

商品APIにGETでアクセスし、JSONの中身を読み取ります。

ネットワーク入門で学んだHTTPS通信の続きです。

やってみる

自宅のPCだけで体験

ブラウザと標準のコマンド画面を使用します。

有料ソフト・会員登録・クレジットカードは不要。

確認する

ゴール

自分で商品データを取得し、id・title・priceを探せる。

CHAPTER 02 / 16

学習前の準備

30〜45分で終わる、低スペックPC向けの実践

理解する

必要な環境

Windows 10/11 または Mac、インターネット接続。

メモリ4GB程度を想定。高性能CPU・GPUは不要。

やってみる

準備するもの

Chrome / Edge / Safariなどのブラウザを開きます。

Windowsは「コマンド プロンプト」、Macは「ターミナル」。

確認する

準備完了の目印

普段のWebサイトを開ければ、まず準備OK。

会社・学校のPCでは通信が制限される場合があります。

CHAPTER 03 / 16

APIとは?

ソフトウェア同士がやりとりするための窓口

自分のPC→ GET →商品API→ JSON →自分のPC

理解する

API = Application Programming Interface

今回はWeb上の商品データを返す「商品API」を使います。

画面に見えないところで、要求と応答が行き来します。

理解する

ネットショップの例

商品画面が「商品1を見せて」とAPIへ要求。

APIが商品名や価格などのデータを返します。

確認する

ここを覚えよう

APIはデータそのものではなく、利用するための接点です。

CHAPTER 04 / 16

通信は往復する

リクエストとレスポンスの違い

自分のPC→ GET →商品API→ JSON →自分のPC

理解する

リクエスト(要求)

GET /products/1:商品ID 1の情報をください。

GETは、データを取得するときによく使うHTTPメソッド。

理解する

レスポンス(応答)

HTTPステータスと、JSON形式の商品データなどを返す。

200は要求が正常に処理されたことを示します。

確認する

一方向ではない

要求を送る → 応答を受け取る、の2段階で考えよう。

CHAPTER 05 / 16

URLを分解してみよう

アクセス先と取得対象を読み解く

理解する

https://dummyjson.com/products/1

https:通信をTLSで保護するHTTPの方式。

dummyjson.com:接続先のホスト名。

/products/1:商品ID 1を指すパス。

確認する

数字を変えると?

末尾を /2 にすると、商品ID 2を指定できます。

CHAPTER 06 / 16

ブラウザでGETしよう

最初のAPI体験:URLを開く

やってみる

STEP 1:アドレス欄に入力

ブラウザを開いて、次のURLを入力してEnter。

https://dummyjson.com/products/1

確認する

STEP 2:結果を読む

JSONの文字列が表示されたら成功。

id、title、price という項目を探します。

理解する

これは何をした?

ブラウザのアドレス欄からGETを送りました。

JavaScriptのfetchとは別の操作です。

CHAPTER 07 / 16

JSONの読み方

キーと値の組み合わせ

理解する

例:商品データ(説明用の短い例)

{"id": 1, "title": "商品名", "price": 100}

id・title・price が「キー」、右側が「値」。

確認する

文字と数字を見分けよう

"商品名" は文字列、1や100は数値。

実際のAPIには、このほかの項目も含まれます。

挑戦する

ミニ問題

実際のJSONで「title」に対応する値を探してみよう。

理解する理解する

JSONとは?

データを「キー」と「値」で表す、文字で書かれたデータ形式。

読み方は「ジェイソン」。APIの応答でよく使われます。

❓ ミニ問題:JSONのtitleはどこ?
「title」がキーで、右側の値が商品名です。実際のAPIで確認してみましょう。
CHAPTER 08 / 16

商品IDを変えてみる

URLを変えると取得する商品も変わる

やってみる

STEP 1:末尾の数字を変える

/products/1 を /products/2 に変更してEnter。

https://dummyjson.com/products/2

確認する

STEP 2:違いを確認

id が 2 になったか確認。

title や price も比較してみましょう。

挑戦する

もう1件試す

/products/3 を開き、idを探してみよう。

CHAPTER 09 / 16

コマンド画面を開く

WindowsとMacで入口が違う

やってみる

Windows 10/11

スタートメニューで「cmd」と検索。

「コマンド プロンプト」を開きます。

やってみる

Mac

command + スペースでSpotlightを開く。

「ターミナル」と入力して起動します。

確認する

黒や白の文字入力画面が出ればOK

コマンドを入力できる状態になりました。

CHAPTER 10 / 16

curlでAPIを呼ぼう

コマンドから同じGETを送信

やってみる

Windows:コマンドを入力

コマンド プロンプト / PowerShellで実行。

curl.exe https://dummyjson.com/products/1

やってみる

Mac:コマンドを入力

ターミナルで実行。

curl https://dummyjson.com/products/1

確認する

成功の目印

JSONが表示され、id・title・priceを確認できる。

Windowsでは curl.exe と書くと別名との混同を避けられます。

CHAPTER 11 / 16

HTTPステータスとは?

要求がどう処理されたかを示す番号

理解する

200 OK

要求が正常に処理されたことを表します。

理解する

404 Not Found

指定したリソースが見つからない場合など。

通信エラーとは違い、HTTP応答は返っています。

理解する

500 Internal Server Error

サーバー側で予期しない問題が起きたことを示します。

確認する

数字の意味を区別

200・404・500はそれぞれ別の状況です。

CHAPTER 12 / 16

ヘッダーを確認しよう

データの中身以外の情報を読む

やってみる

Windows:-i を付けて実行

応答ヘッダーと本文をまとめて表示。

curl.exe -i https://dummyjson.com/products/1

やってみる

Mac:-i を付けて実行

同じURLでHTTPの応答情報を表示。

curl -i https://dummyjson.com/products/1

確認する

結果で探す場所

HTTP/2 200 などのステータス行。

content-type: application/json などのヘッダー。

CHAPTER 13 / 16

取得件数を変えよう

クエリパラメータを体験する

理解する

?limit=3 の意味

取得件数を3件に指定します。

「?」から後ろはクエリ文字列です。

やってみる

ブラウザで次を開く

アドレス欄に入力してEnter。

https://dummyjson.com/products?limit=3

確認する

products 配列を確認

通常、配列の中に商品が3件入ります。

totalなどの付随情報は3とは限りません。

CHAPTER 14 / 16

実践ミッション

自分の手で商品APIを調査しよう

挑戦する

ミッション 1

/products/1 を開き、id・title・priceを探す。

挑戦する

ミッション 2

/products/2 と比べて、変わった項目を見つける。

挑戦する

ミッション 3

curlで商品1を取得。-iでステータスも調べる。

挑戦する

ミッション 4

?limit=3 を開いて、商品が何件あるか数える。

❓ ミッションの答え合わせ
商品1のidは1、商品2のidは2。-iでHTTPステータスとヘッダーを確認し、?limit=3のproducts配列は通常3件です。詳しくは第15章を参照。
CHAPTER 15 / 16

答え合わせと困ったとき

エラーを原因別に切り分ける

確認する

解答の目安

商品1はid=1、商品2はid=2。

-i ではHTTPステータス行とヘッダーが見える。

?limit=3 のproducts配列には通常3件。

理解する

接続できない・DNSエラー

一般のWebサイトが開くか確認。API側の障害もあり得ます。

理解する

404・証明書エラー・curl不明

404はURL確認。証明書検証を無効化しない。

curlがない場合はOS環境とPATHを確認。

CHAPTER 16 / 16

まとめ:APIを呼べた!

次は「取得したデータを使う」段階へ

確認する

今日できるようになったこと

APIの要求と応答を説明できる。

JSONのキーと値を探せる。

curlでGETし、ステータスとヘッダーを読める。

挑戦する

最後のチェック

何も見ずに /products/2 をcurlで取得してみよう。

理解する

次のステップ

SQL入門:データの検索・集計へ。

API応用:POSTや画面表示にも挑戦できます。

APIの応答やコマンドの表示結果は環境・時期により異なります。PDFでは各章をA4で印刷します。従来のPDFは移行検証用に引き続き閲覧できます。