一言でいうと

APIキーは、「あなたがあなた自身であることを証明する合言葉」です。インターネット上で安全にサービスを使うための認証ツールです。

もう少し詳しく

APIキーの仕組みをイメージするなら、「図書館の会員証」のようなものです。図書館を使うときに会員証を見せることで、図書館のスタッフが「この人は登録されている会員だ」と確認できますよね。

APIキーも同じで、プログラムがサービスを使う際に「このプログラムは正規ユーザーのものです」と証明するために使います。OpenWeatherやGoogleマップなどのサービスは、誰でも無制限に使わせることはできないため、APIキーで利用者を管理しているのです。

APIキーは通常、ランダムな英数字の長い文字列です。これを自分のプログラムに組み込むことで、そのサービスの機能を自由に使えるようになります。

よく使われる場面

エラーログやエラーメッセージを見ているときに「Invalid API key」や「API key not found」という表示が出たら、それはAPIキーが間違っているか、設定されていないという意味です。プログラムがサービス側から「あなたは誰ですか?」と問い合わせられているのに、正しい答え(APIキー)が返ってきていない状態です。

関連する言葉

  • 認証(にんしょう):本人確認のこと
  • API:プログラムが別のサービスと通信する仕組みの総称