RESTfulなAPIを理解します

免責事項:この記事は元の記事をsigmarisingブロガーで、許可ブロガーなく再生してはなりません。https://blog.csdn.net/sigmarising/article/details/88777310

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操作から直感的に理解することができません
  • あなたは直感的に操作結果からステータスコードを理解することができます

参考リンク

おすすめ

転載: blog.csdn.net/sigmarising/article/details/88777310