APIとは？
「API」とは、「Application Programming Interface」の頭文字のこと
- 英文字だけの意味だと、『アプリケーション・プログラミング・インターフェイス』で、大雑把に言うと『アプリケーションをプログラミングするためのインターフェース』という意味。
※『インターフェイス』をコンピュータ用語でいうと、「何か」と「何か」をつなぐものという意味
- アプリ内である特定のデータが欲しいとリクエストがある場合にサーバーに必要な情報を取得してアプリにかす流れ
APIのメリット
①ソフトウェア開発の効率化
②セキュリティの向上
③最新情報を簡単に取得可能
①ソフトウェア開発の効率化
APIで組み込むことができる信頼できるプログラムが世の中にすでに存在する場合、そのプログラムと連携することで、自分で1からプログラムを組む必要がなくなり、ソフトウェア開発の効率化がはかれる。プログラム開発側にとって、開発時間を短縮することができるのは大きなメリットで、時間短縮ができれば他の工程に時間を割くことができ、結果的にコスト削減が可能となる。
②セキュリティの向上
各種サービスとAPI連携が行われているため、別アプリケーションログインによる、ログイン認証ができるようになっている。自社でセキュリティレベルの高い会員登録システムを入れるよりも、すでにあるセキュリティレベルの高い会員システムを導入する方がユーザーも安心で、ユーザー新たにユーザー登録をしなくても良い、という大きなメリットがあり、より多くの人に使ってもらえる、というメリットが提供側にもある。
※ちなみに、提供側は、APIの連携前に必ずユーザーの承諾を得る必要があり、ユーザー側も連携サービスを使うにはユーザー情報が共有されることを許可する必要がある。（どの情報が共有されるか、などはサービスにより異なる）
③最新情報を簡単に取得可能
APIを使えば、それぞれのサービスの最新情報をこちら側が毎回更新しなくても取得、利用することができる。
API設計の重要性
- 機能の提供
- 可読性・メンテナンス性
- エラーハンドリング・セキュリティ対策
開発者はAPIの設計がアプリの品質やユーザー体験に大きく影響することを認識した上で、開発をすることが重要
APIの設計で気を付けること
①適切なメソッドを使う
※ RESTfulAPI
Webサービスの設計原則であるRESTを基にしたAPI
- GET(データを取得）
- POST(データを送信・作成)
- PUT(データを更新)
- DELETE(データを削除)
②命名規則を徹底する
③バージョンの管理
- アプリのバージョンと合わせてAPIのバージョンもバージョン１、バージョン２と入れておくと管理しやすい
④画面に依存しない汎用的な設計
- 情報ベースでAPIを作っていく
API連携が必要なアプリ開発
- Swagger・・・APIの設計・構築・文書化、使用のためのオープンソースのソフトウェアフレームワーク
- Postman・・・様々なタイプのAPIリクエストを簡単に作成・送信・テストができる
外部APIを使う際の注意点
- 料金
- SLAの確認(サービス品質保証)
- セキュリティ
- APIの信頼性(APIが止まるとアプリが稼働しなくなる)
参考サイト
今さら聞けないIT用語やたらと耳にするけど「API」って何？
【アプリ開発】アプリ開発におけるAPIとは？API設計でアプリの品質の９割が決まる！？