APIとは。
システム同士をつなぐ窓口を、
業務の例で。

01 — Answer

APIとは

API（エーピーアイ、Application Programming Interface）とは、あるソフトウェアが持つデータや機能を、別のソフトウェアから決まった手順で呼び出せるようにした窓口のことです。デジタル庁が2024年9月30日に改定した「APIテクニカルガイドブック」でも、APIはアプリケーション間のデータ共有を可能にする技術で、異なるシステムが効率的にデータを交換し、機能を共有できるようになると説明されています。人が画面を開いて調べ、別の画面に書き写していた作業を、システム同士が直接やりとりして済ませるのがAPIの役割です。インターネットを通じて提供されるものはWeb APIと呼ばれ、今「API連携」と言うときは、多くがこのWeb APIを指します。

03 — Detail

APIを使うメリット

一番大きいのは、書き写しが無くなることです。別の画面を見ながら手で入力していた情報が自動で入るので、入力の時間と写し間違いが同時に減ります。

情報が新しく保たれる点も見逃せません。CSVなどのファイルを決まった時刻に取り込む方法では、次の取り込みまで情報が古いままです。APIなら必要なときに問い合わせるので、在庫が売れたらすぐ一覧から消す、といった動きが作れます。

自社で一から作らずに済む機能が増えるのも利点です。業界のデータや外部のサービスがAPIを用意していれば、その部分は呼び出すだけで使えます。開発する範囲を自社の強みになる部分に絞れます。

• 入力の手間と間違いが減る相手のデータがそのまま入り、同じ情報を何度も打たずに済みます。
• 情報が新しい問い合わせたときの最新の状態を受け取れます。
• 作る範囲を絞れる外部にある機能は呼び出して使い、自社専用に作る部分を減らせます。

05 — Check

APIを使う、作るときの注意点

最初に読むのは、技術の資料より利用規約です。デジタル庁のガイドブックも、API提供者は利用規約でAPIの利用条件やデータの取り扱い、免責事項を明確に示すよう求めています。社内だけで見てよいのか、お客さまに見せてよいのか、保存してよい期間はあるのかを、規約で確かめてから設計します。

認証にも気を配ります。ガイドブックは、APIキーまたは利用者認証を強く推奨しつつ、APIキーはコピーされる可能性があり強固な対策ではないと注意しています。パラメータにAPIキーを含めない、不要になったキーを削除する、個人の情報を扱うならOpenID Connectのような認証も使う、といった対策が挙げられています。通信はHTTPSに限ります。

呼び出せる回数の上限にも注意が要ります。提供する側は、攻撃や負荷を防ぐために、1日のアクセス回数などに上限を設けることがあります。上限を超えたときや相手が止まっているときにどう動くかを決め、失敗したら担当者に知らせる仕組みを入れておくと、現場が困りません。相手の仕様が変わることもあるので、つなぐ部分は分けて作り、直す場所がすぐ分かるようにします。

FAQ

APIとはのよくある質問

Sources

出典

デジタル庁 APIテクニカルガイドブック（DS-464-2、2024年9月30日）：https://www.digital.go.jp/assets/contents/node/basic_page/field_ref_resources/fe5f0631-c978-42db-8416-6759cfa7e53a/f6ca1b7b/20241001_policies_development_management_outline_04.pdf
国土交通省 電子車検証特設サイト 車検証閲覧API：https://www.denshishakensho-portal.mlit.go.jp/business/api/
国土交通省 電子車検証特設サイト よくあるご質問（事業者の方へ）：https://www.denshishakensho-portal.mlit.go.jp/business/faq/
国土交通省 電子車検証特設サイト 検査対象軽自動車のAPI提供（2025年4月1日）：https://www.denshishakensho-portal.mlit.go.jp/news/064/