brijpandeyji

9 HTTP
Methods
Stay ahead of the
game with these
essential HTTP
methods!

swipe
 brijpandeyji

HTTP Protocol
HTTP stands for Hyper Text
Transfer Protocol. Communication
between client and web servers is
done by sending HTTP Requests
and receiving HTTP Responses.

HTTP Protocol is used

to perform
CRUD operations (Create,
Read, Update, Delete) by
sending HTTP requests with
different HTTP methods.

HTTP methods are also called as HTTP verbs.

swipe
 brijpandeyji

HTTP Request
Structure
Every HTTP request should
have a URL or URI address
(Highlighted in purple)
and a method.
Example URI
http://api.example.com/products?
name=laptop&available=true
The format of a request message includes

A request-lin
Zero or more header field(s) followed by
CRLF (Carriage Return, Line Feed
An empty lin
A message-body (optional)

swipe
 brijpandeyji

HTTP Methods
in REST
REST

It is a set of
REpresentational
State Transfer
architectural principles
for designing web
services.
Web services based on REST Architecture are
known as RESTful web services.

REST makes it easy to

share data between
clients and servers.

REST applications use HTTP methods like GET, POST,

DELETE, PUT, etc., to do CRUD operations.

swipe
 brijpandeyji

Categories of
HTTP Methods You can divide HTTP
methods into two main
categories
Safe HTTP Method
Idempotent Methods
Safe HTTP Methods
It doesn’t change data on the
server. It always returns the
same response, no matter how Example - GET, HEAD
many times it gets called.

Idempotent Methods
It may change data on the
Example - GET,
HEAD, PUT, DELETE, server. It always returns the
TRACE same response, no matter how
many times it gets called.

All safe methods are also idempotent, but not all idempotent
methods are safe.
swipe
 brijpandeyji

The 9 HTTP Methods

GET Metho
POST Metho
PUT Metho
PATCH Metho
DELETE Metho
HEAD Metho
OPTIONS Metho
TRACE Metho
CONNECT Method

Let us now see them in

detail.

swipe
 brijpandeyji

GET Method

A GET Request is used to request

information from a resource
such as a website, a server, or
an API.
Example

GET /api/employees/{employee-id}
Returns a specific employee by employee id.

GET /api/employees
Returns a list of all employees.

Since the GET method should never

change the data on the resources
and just read them(read-only), it is The GET method is also
idempotent.
considered a safe method.

swipe
 brijpandeyji

Test an API with a

GET Method
When we want to test an
API, the most popular
method that we would Therefore, We expect the
following to happen
use is the GET method.

If the resource is accessible, the API returns the 200

Status Code, which means OK
Along with the 200 Status Code, the server usually returns
a response body in XML or JSON format. So, for example,
we expect the [GET] /members endpoint to return a list of
members in XML or JSON
If the server does not support the endpoint, the server
returns the 404 Status Code, which means Not Found
If we send the request in the wrong syntax, the server
returns the 400 Status Code, which means Bad Request.

swipe
 brijpandeyji

POST Method

It creates a new resource on

the backend (server). We send
data to the server in the
request body.
Example

POST /api/employees/department
Creates a department resource.

POST /api/employees/232/
department/114/department-items
Creates a department item using the employee id
and department id.

Two identical POST requests will

create two new equivalent
resources with the same data and
different resource ids. We don’t get
It is neither a safe nor
the same result every time. an idempotent method

swipe
 brijpandeyji

Testing a POST
Endpoint
Since the POST method creates
data, we must be cautious about
changing the data. Testing all
the POST methods in APIs is
highly recommended.
Here are some suggestions that we
can do for testing APIs with POST
methods

Create a resource with the POST method, and it should

return the 201 Status Code
Perform the GET method to check if it created the
resource was successfully created. You should get the 200
status code, and the response should contain the created
resource
Perform the POST method with incorrect or wrong
formatted data to check if the operation fails.

swipe
 brijpandeyji

PUT Method

Using this, we can update an

existing resource by sending
the updated data as the
content of the request body
to the server.
Example

PUT /api/employees/123
Update employee by employee id

If it applies to a collection of
resources, it replaces the whole
collection, so be careful using it. The
server will return the 200 or 204 The PUT method is
status codes after updating. idempotent but not safe.

swipe
 brijpandeyji

Test an API with a

PUT Method
The PUT method is
idempotent, and it Make sure to do the
modifies the entire following operations
resources.

Send a PUT request to the server many times, and it should

always return the same result
When the server completes the PUT request and updates the
resource, the response should come with 200 or 204 status
codes
After the server completes the PUT request, make a GET
request to check if the data is updated correctly on the
resource
If the input is invalid or has the wrong format, the
resource must not be updated.

swipe
 brijpandeyji

PATCH Method

Similar to PUT, PATCH

updates a resource, but it
updates data partially and
not entirely.
Example

PATCH /api/employees/123

“name” : “Brij”

}
Updates name for employee id 123.

The PATCH method updates the

provided fields of the employee
entity. In general, this modification
should be in a standard format like It is neither a safe nor
JSON or XML.
an idempotent method

swipe
 brijpandeyji

Test an API with a

PATCH Method
To test an API with the
PATCH method, follow the
steps for the testing API
with the PUT and the POST
Consider the following methods.
results

Send a PATCH request to the server. The server will

return the 2xx HTTP status code, which means, the
request is successfully received, understood, and
accepted
Perform the GET request and verify that the content
is updated correctly
If the request payload is incorrect or ill-formatted,
the operation must fail.

swipe
 brijpandeyji

DELETE Method

The DELETE method deletes

a resource. Regardless of
the number of calls, it
returns the same result.
Example

DELETE /api/employees/235
Delete employee by employee id.

Most APIs always return the 200

status code even if we try to delete
a deleted resource but in some
APIs, If the target data no longer
The DELETE method is
exists, the method call would return idempotent but not safe.
a 404 status code.

swipe
 brijpandeyji

Testing a DELETE
Endpoint
When it comes to deleting
something on the server,
we should be cautious. We
are deleting data, and it is Then perform the
critical. following actions

Call the POST method to create a new resource. Never test

DELETE with actual data. For example, first, create a new
employee and then try to delete the employee you just
created
Make the DELETE request for a specific resource. For
example, the request [DELETE] /employees/{employee-id}
deletes a employee with the specified employee id
Call the GET method for the deleted employee, which should
return 404, as the resource no longer exists.

swipe
 brijpandeyji

HEAD Method
The HEAD method is similar to
the GET method. But it doesn’t
have any response body, so if it
mistakenly returns the response
body, it must be ignored.
Example

HEAD /api/employees
Similar to GET, but it does not return the list of
emloyees.

Before requesting the GET endpoint,

we can make a HEAD request to
determine the size (Content-length)
of the file or data that we are The HEAD method is
safe and idempotent.
downloading.

swipe
 brijpandeyji

Testing a HEAD

Endpoint
One of the advantages of
the HEAD method is that we
can test the server if it is
available and accessible as
The API can be long as the API supports it.
tested as follows

It is much faster than the GET method because

it has no response body.
The status code we expect to get from the API
is 200.
Before every other HTTP method, we can first
test API with the HEAD method.

swipe
 brijpandeyji

OPTIONS Method
This method is used to get
information about the possible
communication options
(permitted HTTP methods) for
the given URL or an asterisk to
refer to the entire server.

Example

OPTIONS /api/main.html/1.1
Returns permitted HTTP method in this URL

OPTIONS * HTTP/1.1
Returns all permitted methods

Various browsers widely use the

OPTIONS method to check whether
the CORS (Cross-Origin resource The OPTIONS method is
sharing) operation is restricted on safe and idempotent
the targeted API or not.

swipe
 brijpandeyji

Testing an OPTIONS
Endpoint
Depending on whether the
server supports the
OPTIONS method, we can
test the server for the
To try it, consider the times of FATAL failure with
following the OPTIONS method.

Make an OPTIONS request and check

the header and the status code that
returns
Test the case of failure with a
resource that doesn’t support the
OPTIONS method.

swipe
 brijpandeyji

TRACE Method
The TRACE method is for diagnosis
purposes. It creates a loop-back
test with the same request body
that the client sent to the server
before, and the successful response
code is 200 OK.
Example

TRACE /api/main.html
Responds the exact request that client sent.

The TRACE method could be dangerous

because it could reveal credentials. A
hacker could steal credentials,
including internal authentication The TRACE method is
safe and idempotent
headers, using a client-side attack.

swipe
 brijpandeyji

Test an API with a

TRACE Method

Make a standard HTTP request like a

GET request to /api/statu
Replace GET with the TRACE and send
it again
Check what the server returns. If the
response has the same information
as the original request, the TRACE
ability is enabled in the server and
works correctly.

swipe
 brijpandeyji

CONNECT Method
The CONNECT method is for
making end-to-end
connections between a client
and a server. It makes a two-
way connection like a tunnel
between them.
Example

CONNECT www.example.com:443 HTTP/1.1

Connects to the URL provided.

For example, we can use this

method to safely transfer a large
file between the client and the
It is neither a safe nor
server.
an idempotent method

These are the 9 HTTP methods, their uses and a guide on how to
test them. Hope you learned about them in detail.

swipe
 brijpandeyji

For More Interesting

Content

brijpandeyji

Follow Me On
LinkedIn
https://www.linkedin.com/in/brijpandeyji/