RESTfulなAPIを理解します
REST(のRepresentational State転送)、すなわち「プレゼンテーション層の状態転送」は、最初のロイ・トーマス・フィールディングに登場(HTTPプロトコルの設計に関与し、Apacheサーバ)博士論文(2000年)。
APIは、SOAPやXML-RPCと比較され、RESTfulなデザインスタイルは、今、使用する方が簡単であるのは、アプリケーションの広い範囲となっています。
1. RESTとRESTful API
RESTは、ネットワーク内のクライアントとサーバのインタラクティブフォームを記述し、それ自体は実用的で有用ではありませんRESTfulなAPI(RESTスタイルのネットワーク・インターフェース)を設計する方法であるREST。
2. RESTfulなAPIの設計
リソースURIのデザインルール2.1
URIにのみ使用名詞、原則的には、リソースを指定する(通常は複数)の動詞の使用を禁止します。APIは、に展開する必要があります排他的なドメイン APIの参加を検討し、下のバージョンを。
APIは、のためにサポートしなければならない{id}
単一のリソースの動作。
https://api.test.com/v1/books # 一组资源
https://api.test.com/v1/books/137 # 单个资源
# 错误的例子
https://api.test.com/v1/getBooks # API 中出现了动词
HTTP 2.2リクエストの方法は、CRUD操作を示します
- GET:リソースへのアクセスを
- PUT:更新リソース
- POST:新しいリソース
- DELETE:リソースを削除します。
これは、ことは注目に値するRESTfulなと何の「公式」の標準はありません表さHTTP動詞の意味が異なりますが、一般的に類似していることがあり、異なるWebアプリケーションように、。
2.3フォームとステータスコード
通常、リソースを提供するサーバーとクライアント間の発現のいくつかのフォームを使用しjson
、それは他の形態にすることができます。
HTTPステータスコードを経由して、それが直接の結果を反映させることができます。
2.4別個の前端と後端
ウェブPHP、JSP、ASPアーキテクチャを使用せずに、端末は、フロントエンドのレンダリングを変更し、フロントエンドルーティング(角、反応しヴュー)。データを転送し、データの状態を変更するために、エンドとWebサーバーは、RESTfulなAPIを使用してのみです。
3.まとめ
- URIから操作することが直感的に明確なオブジェクト
- この方法は、HTTP操作から直感的に理解することができません
- あなたは直感的に操作結果からステータスコードを理解することができます