
03 JSONレスポンスとパラメータを読む Cat Facts API 編
(シリーズ全編を読む場合は、マガジンで購入がお得です)
今回の目標
JSON形式のレスポンス を読む感覚をつかむ
GPTs(Custom GPT) に ユーザーの指定に応じて件数を変える 例を作る
パラメータとレスポンス構造を一緒に読む練習をする
ここから先では、Cat Facts API を使って「API が返す JSON のどこを読めばよいか」を手順化します。
YAML をただ貼るだけでなく、返ってきたデータの構造を見ながら Action を調整する感覚をつかむ回です。
こんな GPTs(Custom GPT) を作ります
ユーザー: `ランダムな猫の事実を教えて`
GPT: `Cats sleep for 70% of their lives.`
ユーザー: `5個ください`
GPT: `5件分の猫情報を JSON で取得して、日本語でまとめて返す`
Cat Facts API 概要
認証:不要
メソッド:GET
レスポンス形式:JSON
JSON をざっくり理解する
JSON は、テキストでデータ構造を表すための書き方です。
もともとは JavaScript 向けに広まった形式ですが、今では API のデータ受け渡しで非常によく使われます。
便利なのは、項目名と値をセットで送れる ことです。
たとえば `fact` という項目に猫の豆知識を入れたり、`data` という項目の中に複数件の配列を入れたりできます。
{
"data": [
{
"fact": "Cats sleep for 70% of their lives."
}
]
}今回の Cat Facts API でも、ただの文章だけが返るのではなく、こうした構造化された JSON が返ってきます。
そのため、どの項目に何が入っているかを見ながら YAML を書く必要があります。
YAML との違いも軽く押さえておくと分かりやすいです。
JSON は波かっこ `{}` や角かっこ `[]` を使って構造を表す
YAML はインデントで構造を表す
JSON はインデントなしの 1 行でも書けるが、人間には読みにくくなりやすい
YAML は人間には読みやすいが、インデントが崩れると壊れやすい
つまり、JSON はデータ交換向き、YAML は設定を書くときに読みやすい と考えると、最初は整理しやすいです。
必要な構成要素
GPTs(Custom GPT)
JSON形式のレスポンスを返すアクション(Actions)
ユーザー入力に応じた `limit` 値の制御(例:猫の事実数)