RESTful API: How to design paths and identify resources
繼上篇文章RESTful API簡介: 什麼是RESTful? 以及為何需要它?後,
我們知道了RESTful API是resource based的,今天講著重討論該如何設計resource,也就是HTTP URL中path的部分。
Resource based
每個URL都應該對應到一個或多個資源,使用那些使用者與你的服務互動時會需要用到的資源(名詞),
並使用HTTP Method來表明你想要對資源的操作(動詞),比如說你是一個網誌服務,
RESTful API簡介: 什麼是RESTful? 以及為何需要它?
在web開發裡,API是幾乎無所不在,而其中最常見的應該就是基於HTTP協議的RESTful API,
這篇簡介跟討論到底什麼是RESTful,為何有它的出現?
這是RESTful API一系列文章中的一篇,想了解更多關於RESTful API及HTTP的,可以看這篇目錄:
Introduction
首先,什麼是RESTful,可以說它是一種慣例,一個關於HTTP API如何設計的style,
慣例就是並沒有任何的強制性,但當大家都遵守的慣例時,特立獨行的邊緣人可能就會被排擠,
URL簡介: URL是什麼,由哪些部分組成?
這篇文章將會介紹什麼是URL,為何會需要它,以及它是由哪些部分組成的。
什麼是URL
想像你在一座大城市裡,你搭上一部計程車,想要去你朋友家、你小孩的幼兒園、或是去某某旅館,
你必須告訴司機地址; 如果你想聯絡到某人的話,會使用電話號碼; 在政府眼裡每個人有身分證字號。
就像如此,每個東西都有它獨特的識別方法,而且是被大家所公認的,也就是你一說,大家就知道你在說什麼,
知道你所指的是哪個東西,而在網路上,
HTTP headers 簡介: 一些常用的headers
在HTTP協議中,headers對於每個request,response提供了一些額外的資訊,基本上他們就是只是一對key value pair,由冒號(:)隔開,
今天會看看HTTP協議的格式,header在其中的位置,以及介紹一些常用的header們。
HTTP messages
HTTP是一個text based的傳輸協議,general的HTTP request message如下:
<method&
幾個我常用的vim的功能
作為一個軟體工程師,我們花在文字編輯器上的時間一定佔了一定的比例,
更精通熟悉我們使用的編輯器的話,開發的效率可以提升很多,今天就來分享一些我蠻常會用到的vim的功能~
Introduction
Vim是一個modal editor,可以切換在各個模式之間,一開始時是在normal mode,今天要介紹的功能,
都是在normal mode下操作的,按i或a可以進入insert mode,按esc即可以退回normal mode。
我通常比較常使用a,因為當把指標移到最後時,
Introduction to HTTP Response Status Codes: How to use them correctly?
這篇文章會介紹在HTTP協議中,Response status code的作用,有哪些codes以及該如何去使用他們?
這是RESTful API一系列文章中的一篇,想了解更多關於RESTful API及HTTP的,可以看這篇目錄:
RESTful API Design — A practical guide
Client Server Model
HTTP是一個Client-Server的架構,
How to stream data from Blob Storage at your HTTP server using Azure and express.js
這篇文章將會示範如何使用Node.js來下載Azure Blob Storage上的檔案,並且使用Stream的方式,
將檔案儲存到本地端,或是作為一個Server(此篇使用express.js),回傳給你的client,並且根據檔案名稱來設置正確的Content-Type.
Download file from Azure
取得file的Readable Stream
const { ShareServiceClient, StorageSharedKeyCredential
RESTful API Design — A practical guide
此系列文章是Restful API design的教學目錄,將從什麼是API、怎樣是好的API、HTTP協議、RESTful是什麼、以及其他許多當你在設計API時會遇到情況,例如\:Documentation、Pagination、Rate Limiting、Monitoring.
What are HTTP Methods?Which to use and How to use them correctly?
這篇文章主要討論幾個常見的HTTP methods,說明他們分別是否具有哪些特性(Safe、Idempotent),以及他們應該要怎麼使用,比較會是符合大家的期待.
當然寫server的人可以不照著慣例走,不過如此一來,使用這個API的user可能會很不高興,而這個user可以是公司的客戶,可能是公司內部的其他團隊,也可能是未來的自己!
Outline
* HTTP Request message格式
* 常見的methods,以及其特性
* 分別介紹各個method的用法