メインコンテンツへスキップ
見出し画像

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 の窓口で起きていること

    天気アプリを例にすると、裏ではだいたい次のようなことが起きています。

    1. 頼む:アプリが、気象データを持っているサービスの API に「東京の明日の天気をください」と、決まった書き方で送ります

    2. 確かめる:API の側が「この頼み方は正しいか」「頼んできたのは使ってよい相手か」を確認します。相手を見分けるのに使われるのが「APIキー」という、合鍵のような文字列です

    3. 返す:確認できたら、天気のデータを決まった形で返します。アプリはそれを受け取って、晴れマークや気温として画面に表示します

    身近なところでは、ほかにもこんなものが 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. 何のデータか(例:勤怠の記録)

    2. どのシステムからどのシステムへか(例:勤怠システムから給与システムへ)

    3. どのくらいの頻度か(例:毎月1回、毎日など)

    サービスによっては、API を使えるのが上位の料金プランだけ、ということもあります。費用の面も含めて判断してもらいましょう。

    まとめ

    • API は、システム同士がやりとりするための「窓口」

    • 中身を知らなくても、決まった頼み方をすれば使える。ただし頼めるのは「メニューにあること」だけ

    • 「API連携」はシステム同士を窓口経由で自動でつなぐこと。手作業を減らせるが、作って終わりではない

    • APIキーは合鍵。許可の画面は読んでから押す。迷ったら情シスへ

    リールもあわせてどうぞ

    この記事の元になったリールは、こちらです。1分で「レストランの店員さん」の図解が見られるので、同僚に説明するときにも使ってください。

    いまさらITは、今さら聞けないIT用語を、インスタと YouTube ショートで図解しています。前回の完全版は「VPN」でした。

    Note では、このアカウントを AI で回している裏側も連載しています。気になった方はこちらもどうぞ。

     
     
    ITが苦手な会社員向けに、現役SEがIT用語を図解しています。AI社員で副業を回す実録も連載中。インスタ・YouTubeでは1分の図解動画を発信しています。

    あなたへのおすすめ