AutoHotkeyで何かを自動化しようとしたとき、WordPressを触っているとき、AIの使い方を調べているとき。俺はこの3つで「API」という言葉を見かけるようになった。
最初はプログラマー向けの難しい機能に見える。でも意味が分かると、別々に見えたAutoHotkey・WordPress・AIが、同じ仕組みで外部サービスとやり取りできることが見えてくる。
この記事では細かいコードより先に、APIが何なのか・どこで使われるのかを初心者向けに整理する。
APIとは
APIは「Application Programming Interface」の略。簡単に言えば、ソフトやサービス同士が決められた方法で機能やデータをやり取りするための窓口だ。
たとえば天気サービスのAPIへ地域を指定して問い合わせると、気温や降水確率などのデータが返ってくる。こちらはサービス内部の仕組みを全部知らなくても、公開されたルールに沿って頼めばいい。
普段の画面操作では、人がボタンを押して結果を見る。APIではプログラムがリクエストを送り、別のプログラムからレスポンスを受け取る。この違いが分かれば、大体のイメージはつかめる。
APIはアプリそのものではなく、機能やデータを外から使うための接点と思っておけばいい。
やり取りの仕組み
難しい単語はいろいろ出てくるが、最初は次の流れだけで十分だ。
- 使いたいAPIのURLへリクエストを送る
- サービス側が内容と権限を確認する
- 結果やエラーがレスポンスとして返る
Web APIでは、送る先のURLを「エンドポイント」と呼ぶことが多い。データの形式にはJSONがよく使われる。JSONは、項目名と値をセットにした読み書きしやすい形式だ。
たとえばWordPressでは、投稿一覧を取得するためのエンドポイントとして次のような形がある。
https://example.com/wp-json/wp/v2/posts見るだけならGET・新しく作るならPOSTというように、何をしたいかも一緒に伝える。とはいえ、初心者の段階で用語を全部暗記する必要はない。URLへ決められた形で頼み、決められた形で返事を受け取る。この流れが土台になる。
俺がAPIを知った3つの場面
APIという言葉を知る入口は、専用の開発ソフトとは限らない。俺の場合はAutoHotkey・WordPress・AIだった。
AutoHotkey
AutoHotkeyはキー操作やWindowsの作業を自動化できる。PC内の操作だけでも便利だが、外部のWebサービスへHTTPリクエストを送れれば、取得した情報を自動処理へ組み込める。
つまり「キーを押したらソフトを起動する」だけでなく、「キーを押したら外部サービスへ問い合わせ、その結果を使う」ところまで広げられる。ここでAPIが、PC内の自動化とネット上のサービスをつなぐ接点になる。
WordPress
WordPressにはREST APIがあり、投稿・固定ページ・カテゴリ・メディアなどを決められたURLから扱える。公式ドキュメントでも、JSONを送受信してサイトと外部アプリがやり取りする仕組みとして説明されている。
たとえば公開済みの記事を取得するだけでなく、認証すれば投稿の作成・更新といった操作もできる。普段は管理画面でやっていることを、別のツールから行う道が用意されているわけだ。
AI
AIサービスも、チャット画面から使う方法とAPIから使う方法がある。APIなら、自分のプログラムから文章生成・画像生成・データ処理などを呼び出し、その結果を次の処理へつなげられる。
チャットへ毎回同じ指示を手入力するのではなく、決まった作業の中へAIを組み込めるのが大きな違いだ。ただし、ChatGPTの月額プランとAPIの料金は別扱いになる場合がある。ここは「同じAIだから全部込みだろう」と思い込まず、使うサービスの料金ページを確認した方がいい。
APIでできること
サービスによって差はあるが、APIを使う目的は大体このあたりに分かれる。
- データを取得する
- 新しいデータを送る
- 既存データを更新・削除する
- 複数のサービスをつなぐ
- 繰り返し作業を自動化する
たとえばAutoHotkeyで情報を取得し、その結果を整えてWordPressへ送る。途中でAIに文章の分類や要約を任せる。APIが使えると、単体では別々だったツールを1本の流れにできる可能性が出てくる。
もちろん、APIがあるから何でも自由に操作できるわけではない。公開されている機能・権限・回数の範囲で使うものだ。ぶっちゃけ手作業の方が早い場面もある。ただ、何度も同じ操作を繰り返すなら、自動化との相性はかなりいい。
使う前に覚えておくこと
最初に気を付けたいのは、APIキー・料金・利用制限の3つだ。
・APIキー
APIキーは、サービス側が利用者やアプリを識別するための秘密情報として使われる。パスワードに近い感覚で扱い、ブログ本文・公開コード・スクリーンショットへそのまま載せない。OpenAIの公式リファレンスでも、キーを共有したりブラウザなどのクライアント側コードへ露出したりしないよう案内されている。
・料金と回数制限
無料で使えるAPIもあれば、処理量に応じて料金が発生するものもある。一定時間に送れる回数へ上限があるサービスも多い。自動化は人より速く連続実行できるぶん、設定を間違えると想定以上に呼び出す可能性がある。
実際に使うときは、まず公式ドキュメントを見るのが確実だ。今回の内容に近いものでは、WordPress REST API HandbookとOpenAI API Referenceが入口になる。最初から全部読む必要はなく、「認証」「エンドポイント」「サンプル」の3か所を追えば雰囲気をつかみやすい。
まとめ
APIは、ソフトやWebサービス同士が機能・データをやり取りするための窓口だ。AutoHotkeyの自動化・WordPressの投稿管理・AIの機能呼び出しも、APIを通すことで別のツールから扱えるようになる。
最初は横文字だらけで難しそうに見えるが、「決められたURLへ頼むと、決められた形で返事が来る」くらいから入ればいい。コードを丸暗記するより、何を送り・何が返り・どんな権限が必要なのかを見る方が理解しやすい。
俺もAPIという言葉を、AutoHotkey・WordPress・AIという別々の入口から知った。仕組みが分かると、これらは単独の道具ではなく、つなげて使えるものとして見えてくる。まずは興味のあるサービスの公式ドキュメントで、どんな窓口が用意されているかを見るところからで十分だ。
コメント