データは全部JSONで流れている

アプリとアプリが会話するとき、どんな言葉を使っていると思いますか？

答えはJSONです。

JSONとは何か

難しく考えなくていいです。

こういう形のデータです：

{
  "title": "AIを使うなら通信を知れ",
  "author": "casio",
  "published": true
}

「キー：値」のセットが並んでいるだけ。

これが、WebとAPIの共通言語です。

なぜJSONなのか

• 人間にも読める
• どんなプログラミング言語でも扱える
• 軽い（データ量が少ない）

だから世界中のAPIがJSONを使っています。

InstagramのAPI、WordPressのAPI、ChatGPTのAPI。全部JSONでやり取りしています。

実際のデータはこんな感じ

WordPressに記事を投稿するとき、こんなデータを送っています：

{
  "title": "記事タイトル",
  "content": "本文...",
  "status": "publish"
}

Instagramに投稿するとき：

{
  "image_url": "https://example.com/image.jpg",
  "caption": "キャプションのテキスト"
}

どこに何を入れればいいか分かれば、AIに正確な指示が出せます。

AIとJSONが相性がいい理由

AIはテキストを扱うのが得意です。

JSONはテキストです。

だから、

• AIにJSONを読ませる → 内容を理解できる
• AIにJSONを作らせる → 構造化されたデータが出てくる
• AIにJSONを変換させる → フォーマットを変えられる

AIエージェントが「データを整形する」というのは、ほぼ全部JSONの変換作業です。

JSONが読めると何が変わるか

エラーが出たとき、こんなレスポンスが返ってきます：

{
  "error": {
    "message": "Invalid OAuth access token",
    "code": 190
  }
}

これが読めると、「ああ、認証トークンが間違ってる」とすぐ分かります。

読めない人は、エラーをそのままAIに投げるだけ。読める人は、原因を特定してから投げる。

精度が段違いです。

結論

データの流れを理解する上で、JSONを知ることは避けて通れません。

難しいコードは書かなくていい。

「どんな形でデータが流れているか」が分かるだけで、AIとの仕事の精度が変わります。

関連記事

• AIを使うなら通信を知らないのはかなり不利
• Webの正体はリクエストとレスポンスだけ