APIとは

外部のサービスとデータをやり取りするための窓口です。埋め込みより柔軟に連携できます。

まずこれだけ

プログラム同士がやり取りする仕組みです。WordPressではプラグインが使うことが多く、直接扱う機会は多くありません。

APIの意味

APIとは、プログラム同士がやり取りするための窓口です。外部のサービスに対して要求を送ると、決められた形式でデータが返ってきます。人が画面を操作する代わりに、プログラムが直接やり取りする仕組みです。

埋め込みが相手の用意した画面をそのまま表示するのに対して、APIはデータだけを受け取ります。受け取ったデータをどう表示するかは、こちら側で決められます。柔軟な連携ができる一方、扱いには知識が必要になります。

簡単にいうと

プログラム同士がデータをやり取りするための窓口です。

埋め込みとの違い

埋め込みは、相手が用意した表示をそのまま組み込みます。見た目も相手が決めます。

APIはデータだけを受け取り、表示はこちらで作ります。サイトのデザインに合わせられます。

その分、実装の手間がかかります。簡単に済ませたい場合は埋め込み、見た目を統一したい場合はAPIという使い分けになります。

直接扱う機会は多くない

WordPressで運用している場合、APIを直接扱う機会はそれほど多くありません。多くはプラグインが内部で使っています。

予約システムとの連携、決済の処理、外部データの取得などは、プラグインが対応しています。利用者は設定を行うだけです。

そのため、仕組みの概要を理解しておけば、実装まで自分で行う必要はありません。

設定で必要になること

プラグインを使う場合でも、いくつかの設定が必要になります。

  • 連携先のサービスでアカウントを作る
  • 接続用の鍵を発行する
  • 発行された鍵をプラグインに設定する
  • 許可する範囲を指定する

この流れは、どのサービスでもおおむね共通しています。

WordPress自体のAPI

WordPressにも、外部からデータをやり取りするための窓口が用意されています。管理画面の操作にも使われています。

この窓口を通じて、外部のアプリから記事を投稿したり、別のサイトと連携したりできます。

使っていない場合でも、有効になっています。一部の情報が外部から取得できる点には注意します。

できることの例

APIを使うと、次のような連携が可能になります。いずれもプラグインで実現されていることが多くあります。

外部の在庫データを取得して表示する、問い合わせの内容を別のシステムに登録する、予約の空き状況を同期する、といった内容です。

データを自動でやり取りできるため、手作業の転記が不要になります。

注意すべき点

接続用の鍵が漏れると、その権限で操作されます。管理に注意が必要です。

相手のサービスが停止すると、連携も止まります。仕様変更で動かなくなることもあります。

利用の回数や量に制限がある場合もあります。超えると、連携が止まります。

知識がない場合

自分で実装するには、プログラムの知識が必要です。無理に取り組むと、動かないだけでなく安全面の問題も生じます。

プラグインで実現できる範囲にとどめるのが安全です。多くの連携は、既存のプラグインで対応できます。

どうしても必要な場合は、専門の会社に依頼します。

用語に惑わされない

APIという言葉が出てくると難しく感じますが、実際に行うのは設定の入力であることがほとんどです。

鍵を発行して貼り付ける、という作業が中心になります。仕組みの詳細を理解していなくても進められます。

分からない用語が出てきたら、その意味を調べてから進めます。推測で設定しないようにします。

記録しておく

どのサービスと連携しているか、どの鍵を使っているかを記録します。問題が起きたときに必要になります。

アカウントの情報と、鍵の保管場所も記録します。担当者が代わったときに引き継げます。

連携の目的も書いておきます。後から必要性を判断できます。

必要なときだけ使う

連携は便利ですが、管理する対象が増えます。本当に必要かを考えてから導入します。

手作業で足りる範囲であれば、連携しないほうが管理は簡単です。

導入する場合は、止まったときの影響も考えておきます。

まとめ

APIはプログラム同士がデータをやり取りする窓口です。多くはプラグインが使うため、利用者は設定と鍵の管理を行います。