Textbook / 5 min read

API / APIキーの教科書

「APIキーって何?他人に渡して大丈夫なの?」に、5分で答えます。

APIとは何か

API(エーピーアイ)とは、別々のプログラム同士が、決まった手順でやり取りするための「窓口」のことです。あなたが直接触ることはほとんどありませんが、AIツールを連携させたり、自動化を組んだりするときには必ず出てくる言葉です。

たとえるなら
レストランの「注文票とウェイター」です。お客さんは厨房に直接入って料理を作ったりしません。注文票(API)に欲しいものを書いて、ウェイターに渡すだけ。ウェイターが厨房(別のサービス)とのやり取りを、決まった作法でこなしてくれます。プログラム同士のやり取りも同じで、相手の中身を知らなくても、決まった「注文の仕方」さえ守れば、必要な情報や処理を受け取れます。

つまりAPIは、2つの違うシステムが安全に会話するための、あらかじめ決められたドアだと考えてください。ドアの外から勝手に何でもできるわけではなく、開けていい範囲だけが決まっています。

なぜAPIキーが必要か

APIという「窓口」は、誰彼構わず対応してしまうと危険です。そこで使われるのがAPIキーです。「トークン」と呼ばれることもありますが、意味はほぼ同じだと考えて大丈夫です。

APIキーは、会員証や社員証のようなものです。窓口(API)は、キーを見せられて初めて「ああ、あなたですね」と本人だと判断し、対応してくれます。この「本人だと確認する」仕組みを認証と呼びます。APIキーは、その認証を成立させるための「証明書」の役割を持っています。

逆にいえば、APIキーを持っている人は「その人自身」として扱われるということです。だからこそ、キーの扱いには注意が必要になります。とはいえ、正しく管理すれば怖いものではありません。次の表で具体的に見ていきましょう。

危険性・料金・もしもの時

APIキー自体は危ない?キーそのものは単なる「合言葉」の文字列です。人に見られなければ、持っているだけで危険が生じることはありません
毎回お金がかかる?多くのサービスは無料の使用枠を用意しています。個人が試す・小さく使う範囲なら、無料枠だけで足りることがほとんどです
使いすぎたらどうなる?無料枠を超えると多くの場合「そこで止まる」だけです。カード登録済みの従量課金プランでない限り、勝手に高額請求されることはありません
キーが漏れたら?慌てなくて大丈夫です。ほとんどのサービスは管理画面からキーの無効化・再発行がワンクリックでできます。漏れた古いキーを無効にして、新しいキーに差し替えるだけで元通りです
なぜ無料枠があるの?サービス提供側にとって、まず気軽に試してもらうことが大事だからです。「無料枠+使った分だけ課金」という仕組みが業界の標準的なやり方になっています

よくある不安

APIキーを他人に見られたら?
見られただけで即座に被害が出るわけではありませんが、念のため管理画面からそのキーを無効化して再発行してください。多くのサービスで数十秒の作業です。日頃から、チャットやメールの本文にキーをそのまま貼らないようにするだけで、リスクはかなり減らせます。
APIって毎回お金がかかるの?
いいえ。個人利用や小規模な自動化であれば、無料枠の範囲内で収まることが多いです。カード登録なしで使えるサービスも多く、料金が発生する場合も「使った分だけ」の従量課金が基本です。心配なら、契約前に該当サービスの料金ページを確認してください。
自分でAPIを作る必要があるの?
いいえ、必要ありません。多くの場合、あなたはすでに用意されているAPIを「利用する側」です。APIキーを取得して、既存のツールやサービスに設定するだけで連携が完了します。自分でゼロから作るのは、専門的な開発をする場合に限られます。
キーはどこに保管すればいいの?
使用するツールの「設定」画面や、サービスが指定する専用の入力欄に登録するのが基本です。テキストファイルやメモ帳に平文で残したまま放置したり、SNSやチャットで人に送ったりしないことだけ気をつければ十分です。
← 用語の教科書 一覧へ戻る