API
Application Programming Interface
APIとは?
- プログラム同士をつなぐ「窓口」
- 何をどう頼むかを取り決める
- サービス連携の基本
APIが実際に変えるのは、「何を自社で直接作るか」の境界線です。地図、決済、KakaoTalkの通知メッセージ送信、翻訳、AI回答のように、以前なら開発チームが数か月かけて組み込んでいた機能が、登録してキーを発行してもらえばその日の午後に組み込める部品になりました。そのため企画会議の問いも「これを作れるか」から「この機能はどの会社のものを借りて使うか」へと移っています。
実務で出会う形式はいくつかに分かれます。こちらから問い合わせると答えが返ってくるRESTが基本で、必要な項目だけを選んで受け取るGraphQL、逆に相手側で出来事が起きたときに先に知らせてくれるウェブフック(Webhook)があります。決済完了や配送開始のように、いつ届くか分からない連絡は10分ごとに問い合わせるのではなく、Webhookで受け取るほうが適しています。組み込む前に確認すべきは認証方式・呼び出し上限・課金単位の3点です。「毎分60回、月1万件まで無料」のような条件は、後から設計全体を揺るがします。
混同しやすい近い概念も整理しておくと良いでしょう。SDKはそのAPIを言語別に使いやすくまとめた道具一式であり、画面ごと丸ごと組み込むウィジェットは導入は簡単ですが、自社の使い勝手に合わせて変える余地が少ないものです。外部から取り寄せるものだけがAPIというわけではありません。社内の受注システムと在庫システムの間に社内APIを一つ設けておけば、部署ごとにExcelでやり取りしていたファイルがなくなります。検討段階ではドキュメントとサンドボックス(テスト環境)があるかをまず確認します。
最も多い事故は、APIキーをソースコードや共有ドキュメントにそのまま書いておくことです。漏れたキーで第三者が自社アカウントのAIを呼び出せば、請求書は自社に届きます。二つ目は、相手のサービスが永遠に続くと想定する姿勢です。外部APIが30分止まれば自社サービスも一緒に止まり、バージョン終了の告知を見落とすと、ある朝突然連携が丸ごと切れてしまいます。つなぐ設計だけで終わらせず、再試行ルール・代替経路・利用量のアラートまで一緒に決めておく必要があります。
APIの概念はソフトウェアの黎明期からありましたが、今日のWeb APIの事実上の標準であるREST は、ロイ・フィールディング(Roy Fielding)が2000年の博士論文で定義しました。
仮想の事例で見てみましょう。役職員90名、年商240億ウォン(約287,016万円)規模の内装資材流通会社A社の話です。自社モールとオープンマーケット3か所で1日400件以上の注文が入りますが、CSチーム2名が毎朝それぞれのサイトからExcelをダウンロードし、在庫システムに手作業で入力していました。この作業だけで1日2時間30分かかり、在庫がリアルタイムではないため、品切れ商品を販売してしまう誤出荷が月3件発生していました。
- 物流チームの金課長が、オープンマーケットの販売者センターを調べていて「注文照会API」のドキュメントを見つけ、会議でこう言いました。"ダウンロードボタンを押す代わりに、システムが自動で取ってこられるということですね。"
- 外注で開発を任せる代わりに、社内DX担当のイ代理が3週間付きっきりで、マーケット3か所の注文APIから10分ごとに新規注文を取り込み、在庫DBに入れるスクリプトを作りました。
- テスト2週目に、1日の呼び出し上限1,000回に引っかかり、午後の注文処理が4時間遅れました。イ代理は全件照会をやめ、マーケットが注文発生時に先に知らせてくれるウェブフック方式に切り替えました。
- 情報セキュリティ担当の朴チーム長が、APIキーがチーム共有のGoogleシートに書かれているのを見て待ったをかけました。"これは銀行の暗証番号を壁に貼っているようなものです。" キーをすべて再発行し、サーバーの環境変数に移しました。
- 稼働2か月目には、手入力の2時間30分が1日10分の確認作業に減り、誤配送は月3件から0件になりました。CS担当者1名は相談対応に回され、応答待ち時間は12分から4分に短縮されました。
パク・スンテ
金鍾赫