
APIとは?「API連携」の意味を現役SEが図解で解説
リールで「レストランの店員さん」の話を見てくれた方へ。ここは、その続きです。
API の回は、いまさらITのリールのひとつです。ただ、1分では「窓口って具体的に何をしているの?」「API連携って、頼めばすぐできるの?」までは話せませんでした。
この記事では、ITが苦手な会社員の方に向けて、API のしくみ、職場でよく聞くセリフの意味、そして「API連携」の話が出たときに気をつけたいことを、現役SEの私がもう一段くわしく説明します。5分ほどで読めます。
「API連携すれば自動でできますよ」
毎月、勤怠システムから数字を書き出して、給与システムに手で打ち直している。そんな作業がつらくて相談したら、システムに詳しい人がさらっと言います。
それ、API連携すれば自動でできますよ。
えーぴーあい……? 聞き返すのも気まずくて、「あ、そうなんですね」とうなずいてしまう。
その後、新しいツールを選ぶ会議でも「このサービス、APIありますか?」という質問が飛び交う。API って、結局なんなのでしょうか。
ひと言でいうと
API は、システム同士がやりとりするための「窓口」 です。
API は「Application Programming Interface(アプリケーション・プログラミング・インターフェース)」の頭文字です。インターフェースは「接点」「窓口」という意味。あるシステムが「こういう頼み方をしてくれたら、こう返します」と決めて用意した、外向けの受付口だと思ってください。
たとえるなら「レストランの店員さん」
リールと同じたとえで、もう少しくわしく見てみます。
あなた=アプリ、店員さん=API、厨房=システム
レストランで、あなたは厨房に入って自分で料理を作ったりしません。メニューを見て店員さんに注文すると、店員さんが厨房に伝え、できた料理を運んできてくれます。
厨房の中で誰がどんな手順で作っているかは、知らなくていい。決まったメニューから選んで、決まった頼み方をすれば、料理が出てくる。この店員さんが API です。
メニューにないものは頼めない
ここが1分では言えなかったところです。店員さんが受けてくれるのは、メニューに載っているものだけ。「冷蔵庫の中を見せて」「レシピを教えて」と言っても断られます。
API も同じで、システムを作った側が「ここまでなら外に出してもいい」と決めた範囲のことしかできません。だからこそ、システムの中身を守りながら、外とやりとりできるのです。
しくみ:API の窓口で起きていること
天気アプリを例にすると、裏ではだいたい次のようなことが起きています。
頼む:アプリが、気象データを持っているサービスの API に「東京の明日の天気をください」と、決まった書き方で送ります
確かめる:API の側が「この頼み方は正しいか」「頼んできたのは使ってよい相手か」を確認します。相手を見分けるのに使われるのが「APIキー」という、合鍵のような文字列です
返す:確認できたら、天気のデータを決まった形で返します。アプリはそれを受け取って、晴れマークや気温として画面に表示します
身近なところでは、ほかにもこんなものが API を使っています。
「Googleでログイン」:Google の窓口に「この人は本人ですか?」と確認してもらい、その結果を使ってログインしています
Webサイトに埋め込まれた地図:地図サービスが用意した窓口を通して、地図を表示しています
生成AIを組み込んだサービス:AIの会社が用意した窓口に文章を送り、返ってきた答えを表示しているものが多いです
職場でよく聞くセリフと意味
「API連携できますか?」
「そのシステムと、うちの別のシステムを、窓口経由で自動でつなげますか?」という意味です。たとえば勤怠システムの記録を、給与システムが自動で受け取れるようにする、といった使い方です。
「APIが公開されている/されていない」
外から使える窓口が用意されているかどうか、です。公開されていなければ、どんなに頼んでも窓口がないので、API ではつなげません。ツールを選ぶ会議で聞かれるのはこのためです。
「APIキーを発行してください」
窓口を使うための合鍵(APIキー)を作ってください、という意味です。サービスの管理画面で作ることが多く、これがあると「使ってよい相手」として窓口が応じてくれます。
「API制限にひっかかった」
サービスによっては、「1分間に何回まで」「1日に何回まで」のように、窓口に頼める回数に上限があります。それを超えて、しばらく受け付けてもらえなくなった状態です。
「CSVで連携しましょう」
API ではなく、データをファイル(CSV という表の形式)で書き出して、もう一方に取り込むやり方です。窓口がないときや、頻度が少ないときに選ばれます。手間は残りますが、立派な選択肢です。
会社員が気をつけること・やること
いちばん大事なのは、会社のルールと情シス(社内のITを担当する部署)の指示を優先することです。ここに書くのは一般的な話として読んでください。
APIキーは「合鍵」として扱う
APIキーを知っている人は、あなたや会社になりすまして窓口を使えることがあります。チャットやメールに貼る、資料に書きっぱなしにする、といったことは避けましょう。うっかり貼ってしまったときは、隠さずに早めに情シスへ伝えてください。
「このアプリに許可しますか?」の画面は読んでから押す
外部のアプリと会社のアカウントをつなぐとき、「メールの読み取り」「ファイルへのアクセス」などを許可する画面が出ることがあります。これも API を通じて、そのアプリにデータを渡す許可です。何を渡すのかを確かめ、会社で認められたアプリか迷ったら、押す前に情シスに相談しましょう。
「API連携」は作って終わりではない
API は相手のサービスが用意している窓口なので、相手の都合で仕様が変わったり、窓口が終了したりすることがあります。そうなると、昨日まで自動で動いていた連携が止まります。
だから、連携を頼むときは「止まったら誰が気づいて、誰が直すのか」まで決めておくと安心です。
相談するときは「何を・どこからどこへ・どのくらい」を伝える
「API連携できたら楽なのに」と思ったら、次の3つをメモして情シスや詳しい人に相談すると、話が早く進みます。
何のデータか(例:勤怠の記録)
どのシステムからどのシステムへか(例:勤怠システムから給与システムへ)
どのくらいの頻度か(例:毎月1回、毎日など)
サービスによっては、API を使えるのが上位の料金プランだけ、ということもあります。費用の面も含めて判断してもらいましょう。
まとめ
API は、システム同士がやりとりするための「窓口」
中身を知らなくても、決まった頼み方をすれば使える。ただし頼めるのは「メニューにあること」だけ
「API連携」はシステム同士を窓口経由で自動でつなぐこと。手作業を減らせるが、作って終わりではない
APIキーは合鍵。許可の画面は読んでから押す。迷ったら情シスへ
リールもあわせてどうぞ
この記事の元になったリールは、こちらです。1分で「レストランの店員さん」の図解が見られるので、同僚に説明するときにも使ってください。
リール:APIって結局なに?
いまさらITは、今さら聞けないIT用語を、インスタと YouTube ショートで図解しています。前回の完全版は「VPN」でした。
Note では、このアカウントを AI で回している裏側も連載しています。気になった方はこちらもどうぞ。