オープンAPI？Open API？Web API？ REST API？もうわからん・・・

yamato3010.iconん～，色々学習しているうちに何が何だか分からなくなってきたよ～

オープンAPI？Open API？Web API？ REST API？・・・色々似たような用語があって，もうわからないよね。個人用まとめだよ。

REST API

RESTアーキテクチャに従って作られたAPIのこと。

RESTはアーキテクチャなので，RESTの考え方にしたがって作られているWebAPIを「RESTful API」と呼称する。

つまり，

API 用の URL がある

HTTP メソッド (GET, POST 等) でリクエストする

JSON や XML のレスポンスが返ってくる

REST API はアーキテクチャ (= 考え方) で，このアーキテクチャに沿って作られたのが RESTful API

OpenAPI

「Open API Spesification」の略称。

OpenAPI = 仕様 (RESTful API のドキュメントの書き方など)

Swagger = OpenAPI に沿ったドキュメント等を作成するツール

詳しくはOpenAPIを参照。

WEB API

HTTP通信などのWeb技術を用いて構築されたAPIが「WebAPI」と呼ばれる。

そのため，「RSETful API」もWebAPIの1つで「SOAP」やgoogle社の「gRPC」，facebook社の「graphAPI」などもWebAPIに含まれる。

オープンAPI

オープンAPIとは「ある企業が提供するAPIのうちサードパーティーがアクセス可能なAPI」の事を指す。

サードパーティの定義はEuro Banking Associationでは以下5段階に分けられていて，Private以外を指す。

Public：誰でもアクセス可能

Acquaintance:一定契約のもと誰でもアクセス可能　←一般的に言われる「オープンAPI」がこれ。

Member：コミュニティに属するメンバーのみがアクセス可能

Partner：パートナーとの合意に基づきアクセス可能

Private：グループ内のみ

参考