解説
「REST」は、「REpresentational State Transfer」の略です。2000年に、HTTPプロトコル規格の主要著者の一人であるRoy Fielding氏が提唱した分散システムの設計原則です。現在では、そこまで厳密ではなく、ある程度RESTの原則を満たしたWebのソフトウェア設計様式のことを指すことが多いです。RESTの原則に従ったWeb APIは、RESTful APIや、REST APIと呼んだりします。
RESTでは、以下のことが重視されます。
統一されたインターフェース
HTTPメソッドの、GET、POST、PUT、DELETEを使います。これらは、CRUD（Create、Read、Update、Delete）の4つの機能に相当します。結果はHTTPステータスコードで通知します。
ステートレス
ステートレスは、状態がないという意味です。リクエストに、処理に必要な情報をすべて含むようにして、サーバーが問い合わせ内容の状態を把握しないでもよくします。そうすることで、サーバーやクライアントは状態を記憶する必要がなくなります。その結果、分散化やキャッシュの利用が容易になります。実際には、利用にログインが必要なRESTful APIが多いです。
URIで階層構造を作る
URI（URL）で、命令の内容を一意に指定します。また、人にも機械にも理解しやすいようなURLの階層構造にします。
RESTful APIでは、多くの場合、XMLやJSONでデータのやり取りをします。昔はXMLが多かったですが、今はJavaScriptでそのまま処理できるJSONが優勢です。また、結果が複数ページにわたる際は、やり取りするデータの中に、次ページへのリンクを含ませたりします。
サンプル
「REST」のサンプルです。ファイルはUTF-8で保存してください。検証はGoogle Chromeで行なっています。
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<title>「REST」のサンプル</title>
<script src="https://cdn.jsdelivr.net/npm/vue"></script>
<script src="https://unpkg.com/axios/dist/axios.min.js"></script>
<style>
#app {border-collapse: collapse}
#app th, #app td {border: solid 1px #888;}
</style>
</head>
<body>
<table id="app">
<tr>
<th>key</th>
<th>value</th>
</tr>
<tr v-for="(value, key) in info">
<td>{{ key }}</td>
<td>{{ value }}</td>
</tr>
</table>
<script>
new Vue({
el: '#app',
data () {
return {info: null}
},
mounted () {
axios
.get('https://api.github.com/users/Microsoft')
.then(res => this.info = res.data)
.catch(error => console.log(error))
}
})
</script>
</body>
</html>
