無料HTML教材 · 全16章
自宅のPCで学ぶ
はじめてのAPI入門
ブラウザとコマンドで商品データを取得してみよう。Windows 10/11・Mac対応、インストール・登録不要。既存PDFの16ページを章ごとに収録しています。
APIって何?
ブラウザとコマンドで、商品データを取得してみよう
理解する
この教材で学ぶこと
商品APIにGETでアクセスし、JSONの中身を読み取ります。
ネットワーク入門で学んだHTTPS通信の続きです。
やってみる
自宅のPCだけで体験
ブラウザと標準のコマンド画面を使用します。
有料ソフト・会員登録・クレジットカードは不要。
確認する
ゴール
自分で商品データを取得し、id・title・priceを探せる。
学習前の準備
30〜45分で終わる、低スペックPC向けの実践
理解する
必要な環境
Windows 10/11 または Mac、インターネット接続。
メモリ4GB程度を想定。高性能CPU・GPUは不要。
やってみる
準備するもの
Chrome / Edge / Safariなどのブラウザを開きます。
Windowsは「コマンド プロンプト」、Macは「ターミナル」。
確認する
準備完了の目印
普段のWebサイトを開ければ、まず準備OK。
会社・学校のPCでは通信が制限される場合があります。
APIとは?
ソフトウェア同士がやりとりするための窓口
理解する
API = Application Programming Interface
今回はWeb上の商品データを返す「商品API」を使います。
画面に見えないところで、要求と応答が行き来します。
理解する
ネットショップの例
商品画面が「商品1を見せて」とAPIへ要求。
APIが商品名や価格などのデータを返します。
確認する
ここを覚えよう
APIはデータそのものではなく、利用するための接点です。
通信は往復する
リクエストとレスポンスの違い
理解する
リクエスト(要求)
GET /products/1:商品ID 1の情報をください。
GETは、データを取得するときによく使うHTTPメソッド。
理解する
レスポンス(応答)
HTTPステータスと、JSON形式の商品データなどを返す。
200は要求が正常に処理されたことを示します。
確認する
一方向ではない
要求を送る → 応答を受け取る、の2段階で考えよう。
URLを分解してみよう
アクセス先と取得対象を読み解く
理解する
https://dummyjson.com/products/1
https:通信をTLSで保護するHTTPの方式。
dummyjson.com:接続先のホスト名。
/products/1:商品ID 1を指すパス。
確認する
数字を変えると?
末尾を /2 にすると、商品ID 2を指定できます。
ブラウザでGETしよう
最初のAPI体験:URLを開く
やってみる
STEP 1:アドレス欄に入力
ブラウザを開いて、次のURLを入力してEnter。
https://dummyjson.com/products/1
確認する
STEP 2:結果を読む
JSONの文字列が表示されたら成功。
id、title、price という項目を探します。
理解する
これは何をした?
ブラウザのアドレス欄からGETを送りました。
JavaScriptのfetchとは別の操作です。
JSONの読み方
キーと値の組み合わせ
理解する
例:商品データ(説明用の短い例)
{"id": 1, "title": "商品名", "price": 100}
id・title・price が「キー」、右側が「値」。
確認する
文字と数字を見分けよう
"商品名" は文字列、1や100は数値。
実際のAPIには、このほかの項目も含まれます。
挑戦する
ミニ問題
実際のJSONで「title」に対応する値を探してみよう。
理解する理解する
JSONとは?
データを「キー」と「値」で表す、文字で書かれたデータ形式。
読み方は「ジェイソン」。APIの応答でよく使われます。
❓ ミニ問題:JSONのtitleはどこ?
商品IDを変えてみる
URLを変えると取得する商品も変わる
やってみる
STEP 1:末尾の数字を変える
/products/1 を /products/2 に変更してEnter。
https://dummyjson.com/products/2
確認する
STEP 2:違いを確認
id が 2 になったか確認。
title や price も比較してみましょう。
挑戦する
もう1件試す
/products/3 を開き、idを探してみよう。
コマンド画面を開く
WindowsとMacで入口が違う
やってみる
Windows 10/11
スタートメニューで「cmd」と検索。
「コマンド プロンプト」を開きます。
やってみる
Mac
command + スペースでSpotlightを開く。
「ターミナル」と入力して起動します。
確認する
黒や白の文字入力画面が出ればOK
コマンドを入力できる状態になりました。
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 と書くと別名との混同を避けられます。
HTTPステータスとは?
要求がどう処理されたかを示す番号
理解する
200 OK
要求が正常に処理されたことを表します。
理解する
404 Not Found
指定したリソースが見つからない場合など。
通信エラーとは違い、HTTP応答は返っています。
理解する
500 Internal Server Error
サーバー側で予期しない問題が起きたことを示します。
確認する
数字の意味を区別
200・404・500はそれぞれ別の状況です。
ヘッダーを確認しよう
データの中身以外の情報を読む
やってみる
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 などのヘッダー。
取得件数を変えよう
クエリパラメータを体験する
理解する
?limit=3 の意味
取得件数を3件に指定します。
「?」から後ろはクエリ文字列です。
やってみる
ブラウザで次を開く
アドレス欄に入力してEnter。
https://dummyjson.com/products?limit=3
確認する
products 配列を確認
通常、配列の中に商品が3件入ります。
totalなどの付随情報は3とは限りません。
実践ミッション
自分の手で商品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件。
理解する
接続できない・DNSエラー
一般のWebサイトが開くか確認。API側の障害もあり得ます。
理解する
404・証明書エラー・curl不明
404はURL確認。証明書検証を無効化しない。
curlがない場合はOS環境とPATHを確認。
まとめ:APIを呼べた!
次は「取得したデータを使う」段階へ
確認する
今日できるようになったこと
APIの要求と応答を説明できる。
JSONのキーと値を探せる。
curlでGETし、ステータスとヘッダーを読める。
挑戦する
最後のチェック
何も見ずに /products/2 をcurlで取得してみよう。
理解する
次のステップ
SQL入門:データの検索・集計へ。
API応用:POSTや画面表示にも挑戦できます。
APIの応答やコマンドの表示結果は環境・時期により異なります。PDFでは各章をA4で印刷します。従来のPDFは移行検証用に引き続き閲覧できます。