← 教材一覧へ戻る

脱・属人プログラム / 学習ノート

API・APIキー入門

アプリ同士の「受付窓口」と、その"合鍵"の扱い方

自動化やAI活用を進めると、必ず出てくるのが「API(エーピーアイ)」「APIキー」という言葉です。むずかしそうですが、たとえで考えればかんたんです。この教材では、APIとは何か・APIキーとは何かを身近な例で理解し、サービスサイトから鍵を発行して使うまでの一般的な流れ、そしてなぜ厳重に守るのかまでを、非エンジニア向けにまとめます。

これは何?(3行で)

1API=アプリ同士の「受付窓口」。人間が画面を操作する代わりに、プログラムが決まった形で"注文"を出し、"結果"を受け取るための入り口です。
2APIキー=その窓口を使うための「あなた専用の合鍵(=身分証)」。誰が注文したか・料金を誰に請求するかを示すもの。だから他人に渡してはいけません。
3鍵が漏れると、他人に勝手に使われてお金を請求されます。だから「gitに上げない・チャットに貼らない・上限を設定する」——守り方が大切(最後の章+専用教材へ橋渡し)。

APIとは?(受付窓口のたとえ)

レストランを思い浮かべてください。あなた(お客)は厨房に直接入りませんウェイター(窓口)にメニューから注文を伝え、料理を受け取ります。厨房の中身を知らなくても、決まった注文の仕方さえ守れば食事ができます。

API=この「ウェイター(受付窓口)」です。あるサービスの機能を、外のプログラムから決まった形で呼び出して使えるようにした入り口。中身の作りを知らなくても、「こう頼めば・こう返ってくる」というルールに従うだけで使えます。
お客さん = あなたのプログラム
↓ 注文:決まった頼み方で「これください」
↑ 結果:決まった形で「はい、どうぞ」
ウェイター = API(受付窓口)あなたが触れるのは、ここだけ
┈┈ この先は見えない/知らなくていい ┈┈

図|あなたは「厨房(中身)」に直接入らない。ウェイター(API)に決まった形で頼めば、決まった形で返ってくる——中身の作りを知らなくても使えるのがAPIの便利さ。

私たちが普段使う画面(ボタンやフォーム)は"人間用"の入り口。それに対してAPIは"プログラム用"の入り口です。同じ機能を、人はボタンで、プログラムはAPIで呼び出す——という関係になっています。

やりたいことAPIの例(イメージ)
今日の天気を取ってくる天気予報サービスのAPIに「東京の天気は?」と聞くと、気温や降水確率がデータで返る
住所から地図・緯度経度を出す地図サービスのAPIに住所を渡すと、位置情報が返る
AIに文章を書かせる/要約させるAIサービス(Claude・Geminiなど)のAPIに文章を送ると、AIの回答が返る
メッセージを自動送信するチャットサービスのAPIに「この文をこの部屋へ」と頼むと、投稿される

つまりAPIは、自分の作った仕組みに"外部サービスの機能"を組み込むためのコンセントのようなもの。自動化ツールがいろいろなサービスと連携できるのは、各サービスがAPIという窓口を用意しているからです。

APIキーとは?(合鍵・身分証のたとえ)

窓口(API)は誰でも自由に使えるわけではありません。「あなたが誰か」を示す合鍵が必要です。それがAPIキー——多くはsk-xxxxxxxxxxxx... のような長い文字列です。

APIキーには、主に2つの役割があります。

🔑 APIキー sk-a1b2c3d4••••••••
① 身分証:「あなたが誰か」を証明する(=本人しか使えない)
② 会員証:「使った分の料金は"あなた"に請求」というひも付け
この鍵を「注文」に添えて送ると…
あなたのツール/プログラム
① 注文+APIキー🔑 を一緒に送る
サービスの受付窓口(API)
受け取った鍵をチェックして…
本人確認:この注文は"あなた"のもの? → OKなら受け付ける
料金メモ:使った分は"あなた"の請求として記録する
② 結果を返す(+あなたに課金)
あなたのツール/プログラム(結果を受け取る)

図|APIキーは1本の注文で「本人確認(身分証)」と「料金の請求先(会員証)」の2役をこなす。
だから鍵が他人に渡ると "あなたの名義で使われ、あなたに請求" される=パスワードと同じ扱いが必要。

HONEST — APIキーは「パスワードと同じ」
APIキーは実質パスワードです。これ1本で、あなたの名義でサービスを使えてしまいます。人に見せる・チャットに貼る・GitHubに上げる・画面に映すのは絶対に避けてください。漏れたら、後述の手順ですぐに無効化(再発行)します。

もう1つの前提:鍵のほかに「送り先URL(エンドポイント)」も要る

APIを呼び出すには、実は2つが必要です。①送り先のURL(どこへ届けるか)と、②APIキー(誰が頼んだか)。教材のたとえで言うと——送り先URL=受付窓口の"住所"APIキー=その窓口で見せる"合鍵"。住所へ、合鍵を持って行って、はじめて注文が通ります。

① 送り先URL=どこへ(住所)
エンドポイント/host
② APIキー=誰が(合鍵)
あなた専用の鍵
この2つをセットで送る
サービスの受付窓口(API)

図|「住所(送り先URL)」+「合鍵(APIキー)」の2点セットで、はじめて注文が届く。

ここが安心ポイント:Claude Code・Cowork・Codex・普通のチャットAIを使う分には、①の送り先URLは最初からツールに組み込まれています。だからあなたが用意するのはログインか、せいぜい②のAPIキーだけ。「住所」を自分で入力する場面は、ふだんはありません。
使うもの送り先URL(住所)は?あなたがやること
チャットAI
(ブラウザ/アプリ)
組み込み済み(見えない)ログインするだけ
Claude Code / Cowork / Codex組み込み済み(見えない)ログイン、または鍵を1回設定するだけ
汎用の連携ツールなど
(例:n8n)
「host」欄などに自分で指定することがある鍵+送り先URLの両方を設定

「host/エンドポイントを自分で入れる」場面は、いろいろな相手先につなげる汎用ツールや、普段と違う入口・自前サーバーに向けるときだけ。ふだんのAIツールでは裏で自動的に使われているだけで、意識しなくてOKです。

覚えなくていい:送り先URLは「AIに聞いて貼る」で十分

もし「host/エンドポイントURL」を入れる欄に出会っても、URLを暗記する必要はありません「〇〇(サービス名)のAPIエンドポイントを教えて」とAIに聞いて、返ってきたURLを貼る——実際、これで十分回ります(貼ったあとに正しく動くかだけ確認)。分からない用語は、そのままAIに聞くのが一番速いです。

HONEST — 用語は現場でブレる
host(ホスト)=サーバー="建物の住所"(ドメイン部分)エンドポイント=その先の窓口まで含む"完全な住所"、が厳密な区別です。ただ実務では両方まとめて「送り先URL」「エンドポイント」と呼ぶことが多いので、「=注文の届け先の住所」とざっくり捉えれば十分です。

サービスサイトから発行して使うまでの流れ

APIキーは、使いたいサービスの公式サイト(管理画面)で自分で発行します。サービスごとに画面は違いますが、流れはだいたい共通です。ここでは一般的な手順を追います。

  1. そのサービスにアカウント登録・ログインする。(例:AIサービスなら、その会社の開発者向けサイトにサインアップ)
  2. 管理画面(ダッシュボード)を開き、「API」「API keys」「開発者」などの設定へ行く。多くは「Settings(設定)」の中にあります。
  3. 「Create API key(新しいキーを作成)」を押す。用途がわかる名前(例:my-automation)を付けておくと、後で管理しやすいです。
  4. 表示された鍵をその場でコピーする。※ここが最重要 → 下のHONEST参照。
  5. 鍵を .env(ドットエンブ)という設定ファイルに保存する。コードに直接書かず、必ず別ファイルへ。控えの大元はパスワード金庫(Bitwardenなど)に入れておくと安心です。
  6. (多くの場合)支払い方法の登録・利用上限の設定をする。従量課金のサービスは、使用上限や予算アラートをここで必ずかけておきます(次章)。
  7. ツールやコードから、その鍵を使ってAPIを呼び出す。「この鍵の名義で、この注文を」と窓口に伝わり、結果が返ってきます。
HONEST — 鍵は「発行時の一度きり」しか全部見えないことが多い
多くのサービスは、セキュリティのため発行した瞬間にしか鍵の全体を表示しません(あとから見に行くと、sk-...abcd のように一部が隠れている)。その場で必ずコピーして保存してください。控えを取り忘れたら、見に行くのではなく作り直し(再発行)すればOKです(古い鍵は無効化)。
.env(設定ファイル)に入れる、の意味

.env は「鍵や秘密を入れておく専用の箱」です。コードは「.env の中の鍵を読んで使う」形にしておくと、コード本体には鍵が書かれないので、うっかりGitHubに上げても鍵は流出しません(.env は上げない設定にする)。この具体的なやり方は AIの記憶と第二の脳のつくり方 のセキュリティ章にあります。

料金の仕組み(従量課金が基本)

APIの多くは「使った分だけ払う」従量課金です。タクシーのメーターと同じで、呼び出した回数や処理した量に応じて料金が増えます。

HONEST — 「無料で使える」と「APIが無料」は別
普段ブラウザやアプリで無料で使えるサービスでも、API経由の利用は有料(従量課金)のことがよくあります。「画面では無料だったのにAPIにしたら課金された」は"あるある"なので、使う前に料金ページを確認するのが安全です。

なぜ厳重に守るのか&守り方の要点

APIキーは「あなたの名義+請求先」がひも付いた鍵。漏れると他人に使われてお金がかかる/サービスを悪用されるおそれがあります。守り方の"最低ライン"は、むずかしくありません。

やることなぜ
① gitに上げない.env に入れ、.gitignore で除外。GitHubへの流出を構造的に防ぐ(「git add .」を使わないのがコツ)
② チャットに貼らないAIチャットや相談窓口に鍵を貼らない。送った内容はサーバーを通る
③ 上限・アラート従量課金の鍵は使用上限と予算アラートをかける。事故の被害を小さく
④ 画面に映さない録画・画面共有・撮影に鍵を映り込ませない
⑤ 大元は金庫へ控えはローカルの平文メモでなくパスワード金庫(Bitwardenなど)に。バックアップにもなる
もっと深く守りたい人へ

「AIに鍵を見せるか(deny封印)」「保管はローカルか金庫か」といった一段深い設計は、AIの記憶と第二の脳のつくり方 のSTEP4「セキュリティを強化する」にまとまっています。この入門を読んだあとの深掘りにどうぞ。

ちょっと寄り道:APIとMCPの違い

Claude Codeなどを使っているとMCP(エムシーピー)という言葉も出てきます。かんたんに言うと——

API(直接)MCP(コネクタ)
イメージ鍵を自分で管理し、プログラムから窓口を直接たたくAI(Claude等)に外部サービスを"標準の差込口"でつなぐ仕組み
鍵の扱い自分で発行し .env で管理コネクタ側で認証(つないだ範囲がまるごと見えることに注意)
向き自作ツール・自動化に組み込むAIに「このサービスを操作していいよ」と許可してつなぐ

ここでは「別物」とだけ押さえればOK。MCPの詳しい話は 非エンジニアのためのコマンド地図(/mcp の章)や Google DriveとClaude Codeの連携ガイド にあります。

各AIの"コネクタ"(呼び名が違うだけで、同じ概念)

この「つなぐだけで使えるコネクタ」は、Claudeだけのものではありません。ChatGPT・Geminiにも同じ仕組みがあり、呼び名が違うだけです(設定画面で Slack・Gmail・Drive・Notion などを「連携」するあの画面)。

ClaudeGeminiChatGPT
呼び名コネクタ
(Connectors)
接続済みアプリ(Connected Apps)/拡張機能(Extensions)コネクタ(Connectors)+カスタムGPTのアクション
Google系Gmail・Drive・Calendar 等をつなぐGmail・Drive・Calendar・YouTube・マップ等が最初から内蔵(オン/オフで切替)Gmail・Drive・Calendar 等をつなぐ
他社サービスSlack・Notion・Atlassian 等Extensionsマーケットで Slack・Notion・Zoom・Trello 等(+MCP対応も拡大中)GitHub・SharePoint・Dropbox・Box・Notion 等+MCPでカスタム連携(有料プラン中心)
HONEST — 3社に共通する注意点
どれも「つないだ範囲がまるごと見える」のは同じです。たとえばGmailをつなぐと、AIが見えるのは1通ではなくあなたがアクセスできるメール全体。会社の機密が絡むなら、つなぐアカウント(会社ドメインか個人か)と範囲に注意を。対応サービス・料金・地域制限は各社で変わりやすいので、使う前に各社の最新情報で確認してください。

用語ミニ辞典

API=エーピーアイ(Application Programming Interface)
アプリ同士をつなぐ「受付窓口」。プログラムから決まった形で機能を呼び出して使えるようにした入り口。
APIキー=エーピーアイキー
その窓口を使うための"あなた専用の合鍵(身分証+会員証)"。実質パスワード。漏らさない。
.env=ドットエンブ
鍵や秘密を入れておく専用の設定ファイル。コードに直書きせず、ここに入れてGitHubには上げない。
従量課金=じゅうりょうかきん
使った分だけ払う料金方式。上限・アラート設定が事故防止のカギ。
無効化/再発行=むこうか/さいはっこう
鍵を使えなくする/新しく作り直すこと。漏れたら即これ。古い鍵は止まる。
MCP=エムシーピー
AIに外部サービスをつなぐ標準のコネクタ。APIとは別物。つないだ範囲が広く見える点に注意。

まとめ

API=アプリ同士の受付窓口、APIキー=それを使うあなた専用の合鍵(=実質パスワード)。使うときは、サービスの管理画面で発行 → その場でコピー → .env に保存 → 上限を設定 → 呼び出す、という流れです。鍵は漏れるとお金と信用に直結するので、gitに上げない・チャットに貼らない・上限をかける・画面に映さない・大元は金庫へ——この最低ラインだけは必ず守ってください。深い守り方は 第二の脳 のセキュリティ章へ。

あわせて読みたい

AIの基礎(まず全体像をつかむ) … AIの入口の地図。APIがどこに位置するかが分かる。
AIの記憶と第二の脳のつくり方 … APIキーの"守り方"を一段深く(.env・deny封印・金庫・3つの問い)。
Google DriveとClaude Codeの連携ガイド … 「AIに見せた情報はどこへ行くか」とAPI/商用プランのデータ扱い。
Claudeの契約とアカウントの選び方 … API/Team/Enterpriseなど、料金と契約の考え方。

この教材の元ネタ