はじめての本物の API
本物のターミナルから JSONPlaceholder を呼ぶ —— 無料の公開 API
⏱ 想定 ~11 分
01 · 読む
ここまではモック API を叩いてきました。次は本物を叩いてみましょう。
JSONPlaceholder ( jsonplaceholder.typicode.com ) は無料の公開フェイク API で、何百万人ものエンジニアがテストや学習のために使っています。サインアップ不要、 API キー不要、クレジットカード不要。
本物のエンドポイントと本物の JSON レスポンスを持ち、 production の API とまったく同じように振る舞います —— 練習にぴったりのツールです。
ポイントまとめ
- JSONPlaceholder は無料、公開、認証不要
- users、posts、todos、comments、albums、photos のエンドポイントがあります
- レスポンスはフェイクデータですが、フォーマットは本物の API と同じです
- このレッスンは自分の実機のターミナルを使います (サンドボックスではありません)
02 · 実機演習
実機のターミナルを開いてください (サンドボックスではありません)。 curl が使えるか確認します。 Windows PowerShell ユーザーへ: このレッスンのすべてのコマンドは curl ではなく curl.exe を使ってください。
curl --version
03 · 実機演習
todo を 1 件取得します。本物のサーバーに対する本物の GET リクエストです。
curl https://jsonplaceholder.typicode.com/todos/1
04 · 実機演習
すべてのユーザーを取得します。 10 個のユーザーオブジェクトの配列が返ってきます —— JSON の構造をざっと見てみましょう。
curl https://jsonplaceholder.typicode.com/users
05 · 読む
ここまでの進捗を振り返ってみましょう: curl が動くことを確認し、単一のリソースを取得し、ネットワーク上のライブサーバーからユーザー一覧を取得しました。どのレスポンスも構造化された JSON —— 本番のアプリが毎日使っているのと同じフォーマットです。
次はもう一歩進みます。クエリパラメータで結果をフィルターし (全件ダウンロードしなくて済む) 、 POST リクエストで新しいリソースを作成する方法を学びます。この 2 つのパターンが、あなたのスマートフォンのアプリの大半を支えています。
06 · 実機演習
クエリパラメータでフィルタしてみましょう: user ID 1 の投稿だけを取得します。
curl "https://jsonplaceholder.typicode.com/posts?userId=1"
07 · 実機演習
新しいリソースを POST します。 JSONPlaceholder は POST リクエストを受け付け、「作成された」リソース (ID 付き) を返します —— ただし実際には保存されません。
curl -X POST https://jsonplaceholder.typicode.com/posts \
-H "Content-Type: application/json" \
-d '{"title": "My First Post", "body": "Hello from curl!", "userId": 1}'08 · クイズ
JSONPlaceholder とは何ですか?
- JavaScript のライブラリ
- データベースサービス
- テストや学習用の無料の公開フェイク API
- コードエディタ
09 · 空欄補充
ターミナルで _____ コマンドを使うと、コマンドラインから HTTP API を呼べます。
⚠ 全機能のインタラクティブ体験には JavaScript が必要です。JavaScript を有効にして再読み込みしてください。
※ このサイトは独立した教育プロジェクトで、Anthropic の公式製品ではありません。Claude™ は Anthropic, PBC の商標です。