What is restful verb

REST  Verbs specify the actions to be performed on a particular resource or collection of resources . When the client makes a request , It should be in  HTTP  Send the following information in the request ：

• REST  Verb

• Header information

• The main body （ Optional ）

REST  Use  URI  To decode the resources to be processed . There are many available  REST  Verb , But six of them are often used . They are as follows ：

• GET

• POST

• PUT

• PATCH

• DELETE

• OPTIONS

If you are a software developer , Then you will deal with these six problems most of the time . The following table describes the operation 、 Target resources and what happens when the request succeeds or fails ：

The numbers in the success and failure columns of the above table are HTTP The status code . Whenever the client starts REST In operation , Rest is stateless , The customer should know whether the operation method is successful . therefore ,HTTP Status code with response .RET Define the previous status code type for a given operation . It means REST API The previous rules should be strictly followed to implement the client  -  Server communication .

All defined  REST  Services have the following format . It consists of the host and  API  End point composition . API  The endpoint is predefined by the server  URL  route . Every  REST  All requests should reach this path .

REST API URI：

http://HostName/API endpoint/Query(optional)

Let's look at all verbs in more detail .REST API Design begins with the definition of operations and API Endpoint . In the realization of API Before , The design documentation should list all endpoints for a given resource . In the following sections , We carefully observe the use PayPal Of REST API As a use case REST API Endpoint .

GET  Method

GET  Method to get the given resource from the server . To specify a resource ,GET  Several types of  URI  Inquire about ：

• Query parameters

• Path based parameters

If you don't know , All your browsing of the network is performed through the server Get Request to complete . for example , If you type www.google.com, Is actually to get the search page GET request . ad locum , Your browser is a client ,Google Of Web Server is Web The back-end implementer of the service . The success of Get Operation return 200 A status code .

Examples of path parameters ：

Everybody knows that  PayPal.PayPal  Create a settlement agreement with the company . If you register  PayPal  Payment system of , They provide you  REST API, To meet all your billing needs . The example request to obtain settlement agreement information is as follows ：

/v1/payments/billing-agreements/agreement_id

.