HTTP - Quick Guide
HTTP - Quick Guide
tutorialspoint.com/http/http_quick_guide.htm
Advertisements
Previous Page
Next Page
The Hypertext Transfer Protocol (HTTP) is an application-level protocol for distributed,
collaborative, hypermedia information systems. This is the foundation for data
communication for the World Wide Web (ie. internet) since 1990. HTTP is a generic and
stateless protocol which can be used for other purposes as well using extension of its
request methods, error codes and headers.
Basic Features
There are following three basic features which makes HTTP a simple but powerful
protocol:
HTTP is connectionless: The HTTP client ie. browser initiates an HTTP request
and after a request is made, the client disconnects from the server and waits for a
response. The server process the request and re-establish the connection with the
client to send response back.
HTTP is media independent: This means, any type of data can be sent by HTTP
as long as both the client and server know how to handle the data content. This is
required for client as well as server to specify the content type using appropriate
MIME-type.
1/49
HTTP/1.0 uses a new connection for each request/response exchange where as
HTTP/1.1 connection may be used for one or more request/response exchanges.
Basic Architecture
Following diagram shows a very basic architecture of a web application and depicts
where HTTP sits:
Client
The HTTP client sends a request to the server in the form of a request method, URI, and
protocol version, followed by a MIME-like message containing request modifiers, client
information, and possible body content over a TCP/IP connection.
Server
The HTTP server responds with a status line, including the message's protocol version
and a success or error code, followed by a MIME-like message containing server
information, entity metainformation, and possible entity-body content.
2/49
HTTP - Parameters
This chapter is going to list down few of the important HTTP Protocol Parameters and
their syntax in a way they are used in the communication. For example, format for date,
format of URL etc. This will help you in constructing your request and response
messages while writing HTTP client or server programs. You will see complete usage of
these parameters in subsequent chapters while explaining message structure for HTTP
requests and responses.
HTTP Version
HTTP uses a <major>.<minor> numbering scheme to indicate versions of the protocol.
The version of an HTTP message is indicated by an HTTP-Version field in the first line.
Here is the general syntax of specifying HTTP version number:
Example
HTTP/1.0
or
HTTP/1.1
Here if the port is empty or not given, port 80 is assumed for HTTP and an empty
abs_path is equivalent to an abs_path of "/". The characters other than those in the
reserved and unsafe sets are equivalent to their ""%" HEX HEX" encoding.
Example
Following two URIs are equivalent:
http://abc.com:80/~smith/home.html
http://ABC.com/%7Esmith/home.html
http://ABC.com:/%7esmith/home.html
Date/Time Formats
3/49
All HTTP date/time stamps MUST be represented in Greenwich Mean Time (GMT),
without exception. HTTP applications are allowed to use any of the following three
representations of date/time stamps:
Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format
Character Sets
You use character set to specify the character sets that the client prefers. Multiple
character sets can be listed separated by commas. If a value is not specified, the default
is US-ASCII.
Example
US-ASCII
or
ISO-8859-1
or
ISO-8859-7
Content Encodings
A content ecoding values indicate an encoding algorithm has been used to encode the
content before passing it over the network. Content codings are primarily used to allow a
document to be compressed or otherwise usefully transformed without losing the identity.
Example
Accept-encoding: gzip
or
Accept-encoding: compress
or
Accept-encoding: deflate
4/49
Media Types
HTTP uses Internet Media Types in the Content-Type and Accept header fields in order
to provide open and extensible data typing and type negotiation. All the Media-type
values are registered with the Internet Assigned Number Authority ((IANA). Following is a
general syntax to specify media type:
The type, subtype, and parameter attribute names are case- insensitive.
Example
Accept: image/gif
Language Tags
HTTP uses language tags within the Accept-Language and Content-Language fields. A
language tag is composed of 1 or more parts: A primary language tag and a possibly
empty series of subtags:
White space is not allowed within the tag and all tags are case- insensitive.
Example
Where any two-letter primary-tag is an ISO-639 language abbreviation and any two-letter
initial subtag is an ISO-3166 country code.
HTTP - Messages
HTTP is based on client-server architecture model and a stateless request/response
protocol that operates by exchanging messages across a reliable TCP/IP connection.
An HTTP "client" is a program (Web browser or any other client) that establishes a
connection to a server for the purpose of sending one or more HTTP request messages.
An HTTP "server" is a program ( generally a web server like Apache Web Server or
Internet Information Services IIS etc. ) that accepts connections in order to serve HTTP
requests by sending HTTP response messages.
HTTP makes use of the Uniform Resource Identifier (URI) to identify a given resource
and to establish a connection. Once connection is established, HTTP messages are
passed in a format similar to that used by Internet mail [RFC5322] and the Multipurpose
5/49
Internet Mail Extensions (MIME) [RFC2045]. These messages are consisted of requests
from client to server and responses from server to client which will have following format:
HTTP request and HTTP response use a generic message format of RFC 822 for
transferring the required data. This generic message format consists of following four
items.
A Start-line
Zero or more header fields followed by CRLF
An empty line (i.e., a line with nothing preceding the CRLF) indicating the end of the
header fields
Optionally a message-body
Following section will explain each of the entities used in HTTP message.
Message Start-Line
A start-line will have following generic syntax:
We will discuss Request-Line and Status-Line while discussing HTTP Request and HTTP
Response messages respectively. For now let's see the examples of start line in case of
request and response:
Header Fields
HTTP deader fields provide required information about the request or response, or about
the object sent in the message body. There are following four types of HTTP message
headers:
General-header: These header fields have general applicability for both request
and response messages.
Request-header: These header fields are applicability only for request messages.
All the above mentioned headers follow the same generic format and each of the header
field consists of a name followed by a colon (:) and the field value as follows:
6/49
message-header = field-name ":" [ field-value ]
Message Body
The message body part is optional for an HTTP message but if it is available then it is
used to carry the entity-body associated with the request or response. If entity body is
associated then usually Content-Type and Content-Length headers lines specify the
nature of the body associated.
A message body is the one which carries actual HTTP request data (including form data
and uploaded etc.) and HTTP response data from the server ( including files, images etc).
Following is a simple content of a message body:
<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
HTTP - Requests
An HTTP client sends an HTTP request to a server in the form of a request message
which includes following format:
A Request-line
Zero or more header (General|Request|Entity) fields followed by CRLF
An empty line (i.e., a line with nothing preceding the CRLF) indicating the end of the
header fields
Optionally a message-body
Following section will explain each of the entities used in HTTP message.
Message Request-Line
The Request-Line begins with a method token, followed by the Request-URI and
the protocol version, and ending with CRLF. The elements are separated by space
SP characters.
7/49
Request-Line = Method SP Request-URI SP HTTP-Version CRLF
Request Method
The request Method indicates the method to be performed on the resource identified by
the given Request-URI. The method is case-sensitive ans should always be mentioned
uppercase. Following are supported methods in HTTP/1.1
1 GET
The GET method is used to retrieve information from the given server using a
given URI. Requests using GET should only retrieve data and should have no
other effect on the data.
2 HEAD
Same as GET, but only transfer the status line and header section.
3 POST
A POST request is used to send data to the server, for example customer
information, file upload etc using HTML forms.
4 PUT
Replace all current representations of the target resource with the uploaded
content.
5 DELETE
Remove all current representations of the target resource given by URI.
6 CONNECT
Establish a tunnel to the server identified by a given URI.
7 OPTIONS
Describe the communication options for the target resource.
8 TRACE
Perform a message loop-back test along the path to the target resource.
Request-URI
The Request-URI is a Uniform Resource Identifier and identifies the resource upon which
to apply the request. Following are the most commonly used forms to specify an URI:
8/49
1 The asterisk * is used when HTTP request does not apply to a particular
resource, but to the server itself, and is only allowed when the method used
does not necessarily apply to a resource. For example:
OPTIONS * HTTP/1.1
2 The absoluteURI is used when HTTP request is being made to a proxy. The
proxy is requested to forward the request or service it from a valid cache, and
return the response. For example:
GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1
Note that the absolute path cannot be empty; if none is present in the original
URI, it MUST be given as "/" (the server root)
The request-header fields allow the client to pass additional information about the
request, and about the client itself, to the server. These fields act as request modifiers
and there are following important Request-header fields available which can be used
based on requirement.
Accept-Charset
Accept-Encoding
Accept-Language
Authorization
Expect
From
Host
If-Match
If-Modified-Since
If-None-Match
9/49
If-Range
If-Unmodified-Since
Max-Forwards
Proxy-Authorization
Range
Referer
TE
User-Agent
You can introduce your custom fields in case you are going to write your own custom
Client and Web Server.
Here we are not sending any request data to the server because we are fetching a plan
HTML page from the server. Connection is a general-header used here and rest of the
headers are request headers. Following is one more example where we send form data
to the server using request message body:
licenseID=string&content=string&/paramsXML=string
Here given URL /cgi-bin/process.cgi will be used to process the passed data and
accordingly a response will be retuned. Here content-type tells the server that passed
data is simple web form data and length will be actual length of the data put in the
10/49
message body. Following example shows how you can pass plan XML to your web
server:
HTTP - Responses
After receiving and interpreting a request message, a server responds with an HTTP
response message:
A Status-line
Zero or more header (General|Response|Entity) fields followed by CRLF
An empty line (i.e., a line with nothing preceding the CRLF) indicating the end of the
header fields
Optionally a message-body
Following section will explain each of the entities used in HTTP message.
Message Status-Line
The Status-Line consisting of the protocol version followed by a numeric status
code and its associated textual phrase. The elements are separated by space SP
characters.
HTTP Version
A server supporting HTTP version 1.1 will return following version information:
HTTP-Version = HTTP/1.1
Status Code
The Status-Code element is a 3-digit integer where first digit of the Status-Code defines
the class of response and the last two digits do not have any categorization role. There
are 5 values for the first digit:
11/49
S.N. Code and Description
1 1xx: Informational
This means request received and continuing process.
2 2xx: Success
This means the action was successfully received, understood, and accepted.
3 3xx: Redirection
This means further action must be taken in order to complete the request.
HTTP status codes are extensible and HTTP applications are not required to understand
the meaning of all registered status codes. A list of all the status code has been given in a
separate chapter for you reference.
The response-header fields allow the server to pass additional information about the
response which cannot be placed in the Status- Line. These header fields give
information about the server and about further access to the resource identified by the
Request-URI.
Accept-Ranges
Age
ETag
Location
Proxy-Authenticate
Retry-After
Server
Vary
WWW-Authenticate
You can introduce your custom fields in case you are going to write your own custom
Web Client and Server.
12/49
Response Message Examples
Now let's put it all together to form an HTTP response for a request to fetch hello.htm
page from the web server running on tutorialspoint.com
HTTP/1.1 200 OK
Date: Mon, 27 Jul 2009 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Wed, 22 Jul 2009 19:15:56 GMT
Content-Length: 88
Content-Type: text/html
Connection: Closed
<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
Following is an example of HTTP response message showing error condition when web
server could not find requested page:
Following is an example of HTTP response message showing error condition when web
server encountered a wrong HTTP version in given HTTP request:
13/49
HTTP/1.1 400 Bad Request
Date: Sun, 18 Oct 2012 10:36:20 GMT
Server: Apache/2.2.14 (Win32)
Content-Length: 230
Content-Type: text/html; charset=iso-8859-1
Connection: Closed
HTTP - Methods
The set of common methods for HTTP/1.1 is defined below and this set can be expanded
based on requirement. These method names are case sensitive and they must be used in
uppercase.
1 GET
The GET method is used to retrieve information from the given server using a
given URI. Requests using GET should only retrieve data and should have no
other effect on the data.
2 HEAD
Same as GET, but only transfer the status line and header section.
3 POST
A POST request is used to send data to the server, for example customer
information, file upload etc using HTML forms.
4 PUT
Replace all current representations of the target resource with the uploaded
content.
5 DELETE
Remove all current representations of the target resource given by URI.
6 CONNECT
Establish a tunnel to the server identified by a given URI.
7 OPTIONS
Describe the communication options for the target resource.
14/49
8 TRACE
Perform a message loop-back test along the path to the target resource.
GET Method
A GET request retrieves data from a web server by specifying parameters in the URL
portion of the request. This is the main method used for document retrieval. Following is a
simple example which makes use of GET method to fetch hello.htm:
The server response against the above GET request will be as follows:
HTTP/1.1 200 OK
Date: Mon, 27 Jul 2009 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Wed, 22 Jul 2009 19:15:56 GMT
ETag: "34aa387-d-1568eb00"
Vary: Authorization,Accept
Accept-Ranges: bytes
Content-Length: 88
Content-Type: text/html
Connection: Closed
<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
HEAD Method
The HEAD method is functionally like GET, except that the server replies with a response
line and headers, but no entity-body. Following is a simple example which makes use of
HEAD method to fetch header information about hello.htm:
15/49
HTTP/1.1 200 OK
Date: Mon, 27 Jul 2009 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Wed, 22 Jul 2009 19:15:56 GMT
ETag: "34aa387-d-1568eb00"
Vary: Authorization,Accept
Accept-Ranges: bytes
Content-Length: 88
Content-Type: text/html
Connection: Closed
You can notice that here server does not send any data after header.
POST Method
The POST method is used when you want to send some data to the server, for example
file update, form data etc. Following is a simple example which makes use of POST
method to send a form data to the server which will be processed by a process.cgi and
finally a response will be returned:
Server side script process.cgi process the passed data and send following response:
HTTP/1.1 200 OK
Date: Mon, 27 Jul 2009 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Wed, 22 Jul 2009 19:15:56 GMT
ETag: "34aa387-d-1568eb00"
Vary: Authorization,Accept
Accept-Ranges: bytes
Content-Length: 88
Content-Type: text/html
Connection: Closed
<html>
<body>
<h1>Request Processed Successfully</h1>
</body>
</html>
PUT Method
16/49
The PUT method is used to request the server to store the included entity-body at a
location specified by the given URL. The following example request server to save the
given entity-body in hello.htm at the root of the server:
<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
The server will store given entity-body in hello.htm file and will send following response
back to the client:
<html>
<body>
<h1>The file was created.</h1>
</body>
</html>
DELETE Method
The DELETE method is used to request the server to delete file at a location specified by
the given URL. The following example request server to delete the given file hello.htm at
the root of the server:
The server will delete mentioned file hello.htm and will send following response back to
the client:
17/49
HTTP/1.1 200 OK
Date: Mon, 27 Jul 2009 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Content-type: text/html
Content-length: 30
Connection: Closed
<html>
<body>
<h1>URL deleted.</h1>
</body>
</html>
CONNECT Method
The CONNECT method is used by the client to establish a network connection to a web
server over HTTP. The following example request a connection with a web server running
on host tutorialspoint.com:
The connection is established with the server and following response is sent back to the
client:
OPTIONS Method
The OPTIONS method is used by the client to find out what are the HTTP methods and
other options supported by a web server. The client can specify a URL for the OPTIONS
method, or an asterisk (*) to refer to the entire server. The following example request a list
of methods supported by a web server running on tutorialspoint.com:
OPTIONS * HTTP/1.1
User-Agent: Mozilla/4.0 (compatible; MSIE5.01; Windows NT)
The server will send information based on the current configuration of the server, for
example:
HTTP/1.1 200 OK
Date: Mon, 27 Jul 2009 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Allow: GET,HEAD,POST,OPTIONS,TRACE
Content-Type: httpd/unix-directory
TRACE Method
18/49
The TRACE method is used to eacho the contents of an HTTP Request back to the
requester which can be used for debugging purpose at the time of development. The
following example shows the usage of TRACE method:
TRACE / HTTP/1.1
Host: www.tutorialspoint.com
User-Agent: Mozilla/4.0 (compatible; MSIE5.01; Windows NT)
The server will send following message in response of the above request:
HTTP/1.1 200 OK
Date: Mon, 27 Jul 2009 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Content-Type: message/http
Content-Length: 39
Connection: Closed
TRACE / HTTP/1.1
Host: www.tutorialspoint.com
User-Agent: Mozilla/4.0 (compatible; MSIE5.01; Windows NT)
1 1xx: Informational
This means request received and continuing process.
2 2xx: Success
This means the action was successfully received, understood, and accepted.
3 3xx: Redirection
This means further action must be taken in order to complete the request.
HTTP status codes are extensible and HTTP applications are not required to understand
the meaning of all registered status codes. Following is a list of all the status code.
1xx: Information
Message: Description:
19/49
100 Only a part of the request has been received by the server, but as long
Continue as it has not been rejected, the client should continue with the request
2xx: Successful
Message: Description:
202 The request is accepted for processing, but the processing is not
Accepted complete
203 Non- The information in the entity header is from a local or third-party copy,
authoritative not from the original server.
Information
204 No A status code and header are given in the response, but there is no
Content entity-body in the reply.
205 Reset The browser should clear the form used for this transaction for additional
Content input.
206 Partial The server is returning partial data of the size requested. Used in
Content response to a request specifying a Range header. The server must
specify the range included in the response with the Content-Range
header.
3xx: Redirection
Message: Description:
300 Multiple A link list. The user can select a link and go to that location. Maximum
Choices five addresses
302 Found The requested page has moved temporarily to a new url
303 See The requested page can be found under a different url
Other
20/49
305 Use The requested URL must be accessed through the proxy mentioned in
Proxy the Location header.
306 Unused This code was used in a previous version. It is no longer used, but the
code is reserved
Message: Description:
404 Not Found The server can not find the requested page
406 Not The server can only generate a response that is not accepted by the
Acceptable client
407 Proxy You must authenticate with a proxy server before this request can be
Authentication served
Required
408 Request The request took longer than the server was prepared to wait
Timeout
411 Length The "Content-Length" is not defined. The server will not accept the
Required request without it
412 The precondition given in the request evaluated to false by the server
Precondition
Failed
413 Request The server will not accept the request, because the request entity is
Entity Too too large
Large
21/49
414 Request- The server will not accept the request, because the url is too long.
url Too Long Occurs when you convert a "post" request to a "get" request with a
long query information
415 The server will not accept the request, because the media type is not
Unsupported supported
Media Type
416 Requested The requested byte range is not available and is out of bounds.
Range Not
Satisfiable
Message: Description:
500 Internal Server The request was not completed. The server met an unexpected
Error condition
501 Not The request was not completed. The server did not support the
Implemented functionality required
502 Bad Gateway The request was not completed. The server received an invalid
response from the upstream server
503 Service The request was not completed. The server is temporarily
Unavailable overloading or down
505 HTTP Version The server does not support the "http protocol" version
Not Supported
General-header: These header fields have general applicability for both request
and response messages.
Client Request-header: These header fields are applicability only for request
messages.
22/49
Server Response-header: These header fields are applicability only for response
messages.
General Headers
Cache-control
Cache-Control : cache-request-directive|cache-response-directive
An HTTP clients or servers can use the Cache-control general header to specify
parameters for the cache or to request certain kinds of documents from the cache. The
caching directives are specified in a comma-separated list. For example:
Cache-control: no-cache
There are following important cache request directives which can be used by the client in
its HTTP request:
1 no-cache
A cache must not use the response to satisfy a subsequent request without
successful revalidation with the origin server.
2 no-store
The cache should not store anything about the client request or server
response.
3 max-age = seconds
Indicates that the client is willing to accept a response whose age is no greater
than the specified time in seconds.
4 max-stale [ = seconds ]
Indicates that the client is willing to accept a response that has exceeded its
expiration time. If seconds are given, it must not be expired by more than that
time.
5 min-fresh = seconds
Indicates that the client is willing to accept a response whose freshness lifetime
is no less than its current age plus the specified time in seconds.
6 no-transform
Do not convert the entity-body.
23/49
7 only-if-cached
Do not retrieve new data. The cache can send a document only if it is in the
cache, and should not contact the origin-server to see if a newer copy exists.
There are following important cache response directives which can be used by the server
in its HTTP response:
1 public
Indicates that the response may be cached by any cache.
2 private
Indicates that all or part of the response message is intended for a single user
and must not be cached by a shared cache.
3 no-cache
A cache must not use the response to satisfy a subsequent request without
successful revalidation with the origin server.
4 no-store
The cache should not store anything about the client request or server
response.
5 no-transform
Do not convert the entity-body.
6 must-revalidate
The cache must verify the status of stale documents before using it and expired
one should not be used.
7 proxy-revalidate
The proxy-revalidate directive has the same meaning as the must- revalidate
directive, except that it does not apply to non-shared user agent caches.
8 max-age = seconds
Indicates that the client is willing to accept a response whose age is no greater
than the specified time in seconds.
9 s-maxage = seconds
The maximum age specified by this directive overrides the maximum age
specified by either the max-age directive or the Expires header. The s-maxage
directive is always ignored by a private cache.
Connection
The Connection general-header field allows the sender to specify options that are desired
for that particular connection and must not be communicated by proxies over further
connections. Following is the simple syntax of using connection header:
Connection : "Connection"
24/49
HTTP/1.1 defines the "closed" connection option for the sender to signal that the
connection will be closed after completion of the response. For example:
Connection: Closed
By default, HTTP 1.1 uses persistent connections, where the connection does not
automatically close after a transaction. HTTP 1.0, on the other hand, does not have
persistent connections by default. If a 1.0 client wishes to use persistent connections, it
uses the keep-alive parameter as follows:
Connection: keep-alive
Date
All HTTP date/time stamps MUST be represented in Greenwich Mean Time (GMT),
without exception. HTTP applications are allowed to use any of the following three
representations of date/time stamps:
Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format
Pragma
Pragma: no-cache
The only directive defined in HTTP/1.0 is the no-cache directive and is maintained in
HTTP 1.1 for backward compatibility. No new Pragma directives will be defined in the
future.
Trailer
The Trailer general field value indicates that the given set of header fields is present in
the trailer of a message encoded with chunked transfer-coding. Following is the syntax of
Trailer header field:
Trailer : field-name
Message header fields listed in the Trailer header field must not include the following
header fields:
Transfer-Encoding
Content-Length
Trailer
25/49
Transfer-Encoding
Transfer-Encoding: chunked
Upgrade
The Upgrade general-header allows the client to specify what additional communication
protocols it supports and would like to use if the server finds it appropriate to switch
protocols. For example:
The Upgrade header field is intended to provide a simple mechanism for transition from
HTTP/1.1 to some other, incompatible protocol
Via
The Via general-header must be used by gateways and proxies to indicate the
intermediate protocols and recipients. For example, a request message could be sent
from an HTTP/1.0 user agent to an internal proxy code-named "fred", which uses
HTTP/1.1 to forward the request to a public proxy at nowhere.com, which completes the
request by forwarding it to the origin server at www.ics.uci.edu. The request received by
www.ics.uci.edu would then have the following Via header field:
The Upgrade header field is intended to provide a simple mechanism for transition from
HTTP/1.1 to some other, incompatible protocol
Warning
The Warning general-header is used to carry additional information about the status or
transformation of a message which might not be reflected in the message. A response
may carry more than one Warning header.
Accept
26/49
The Accept request-header field can be used to specify certain media types which are
acceptable for the response. Following is the general syntax:
Multiple media types can be listed separated by commas and the optional qvalue
represents an acceptable quality level for accept types on a scale of 0 to 1. Following is
an example:
This would be interpreted as text/html and text/x-c are the preferred media types, but if
they do not exist, then send the text/x-dvi entity, and if that does not exist, send the
text/plain entity.
Accept-Charset
The Accept-Charset request-header field can be used to indicate what character sets are
acceptable for the response. Following is the general syntax:
Multiple character sets can be listed separated by commas and the optional qvalue
represents an acceptable quality level for nonpreferred character sets on a scale of 0 to
1. Following is an example:
The special value "*", if present in the Accept-Charset field, matches every character set
and if no Accept-Charset header is present, the default is that any character set is
acceptable.
Accept-Encoding
The Accept-Encoding request-header field is similar to Accept, but restricts the content-
codings that are acceptable in the response. Following is the general syntax:
Accept-Language
27/49
The Accept-Language request-header field is similar to Accept, but restricts the set of
natural languages that are preferred as a response to the request. Following is the
general syntax:
Multiple languages can be listed separated by commas and the optional qvalue
represents an acceptable quality level for nonpreferred languages on a scale of 0 to 1.
Following is an example:
Authorization
Authorization : credentials
The HTTP/1.0 specification defines the BASIC authorization scheme, where the
authorization parameter is the string of username:password encoded in base 64.
Following is an example:
The value decodes into is guest:guest123 where guest is user ID and guest123 is the
password.
Cookie
The Cookie request-header field value contains a name/value pair of information stored
for that URL. Following is the general syntax:
Cookie: name=value
Cookie: name1=value1;name2=value2;name3=value3
Expect
The Expect request-header field is used to indicate that particular server behaviors are
required by the client. Following is the general syntax:
From
28/49
The From request-header field contains an Internet e-mail address for the human user
who controls the requesting user agent. Following is a simple example:
From: webmaster@w3.org
This header field may be used for logging purposes and as a means for identifying the
source of invalid or unwanted requests.
Host
The Host request-header field is used to specify the Internet host and port number of the
resource being requested. Following is the general syntax:
A host without any trailing port information implies the default port, which is 80. For
example, a request on the origin server for http://www.w3.org/pub/WWW/ would be:
If-Match
The If-Match request-header field is used with a method to make it conditional. This
header request the server to perform the requested method only if given value in this tag
matches the given entity tags represented by ETag. Following is the general syntax:
If-Match : entity-tag
An asterisk (*) matches any entity, and the transaction continues only if the entity exists.
Following are possible examples:
If-Match: "xyzzy"
If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
If-Match: *
If none of the entity tags match, or if "*" is given and no current entity exists, the server
must not perform the requested method, and must return a 412 (Precondition Failed)
response.
If-Modified-Since
The If-Modified-Since request-header field is used with a method to make it conditional. If
the requested URL has not been modified since the time specified in this field, an entity
will not be returned from the server; instead, a 304 (not modified) response will be
returned without any message-body. Following is the general syntax:
If-Modified-Since : HTTP-date
29/49
If none of the entity tags match, or if "*" is given and no current entity exists, the server
must not perform the requested method, and must return a 412 (Precondition Failed)
response.
If-None-Match
The If-None-Match request-header field is used with a method to make it conditional. This
header request the server to perform the requested method only if one of the given value
in this tag matches the given entity tags represented by ETag. Following is the general
syntax:
If-None-Match : entity-tag
An asterisk (*) matches any entity, and the transaction continues only if the entity does
not exist. Following are possible examples:
If-None-Match: "xyzzy"
If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
If-None-Match: *
If-Range
The If-Range request-header field can be used with a conditional GET to request only the
portion of the entity that is missing, if it has not been changed, and the entire entity if it
has changed. Following is the general syntax:
Either an entity tag or a date can be used to identify the partial entity already received.
For example:
Here if the document has not been modified since the given date, the server returns the
byte range given by the Range header otherwise, it returns all of the new document.
If-Unmodified-Since
If-Unmodified-Since : HTTP-date
If the requested resource has not been modified since the time specified in this field, the
server should perform the requested operation as if the If-Unmodified-Since header were
not present. For example:
If the request normally would result in anything other than a 2xx or 412 status, the If-
Unmodified-Since header should be ignored.
30/49
Max-Forwards
The Max-Forwards request-header field provides a mechanism with the TRACE and
OPTIONS methods to limit the number of proxies or gateways that can forward the
request to the next inbound server. Following is the general syntax:
Max-Forwards : n
The Max-Forwards value is a decimal integer indicating the remaining number of times
this request message may be forwarded. This is useful for debugging with the TRACE
method, avoiding infinite loops. For example:
Max-Forwards : 5
The Max-Forwards header field may be ignored for all other methods defined in HTTP
specification.
Proxy-Authorization
The Proxy-Authorization request-header field allows the client to identify itself (or its user)
to a proxy which requires authentication. Following is the general syntax:
Proxy-Authorization : credentials
Range
The Range request-header field specifies the partial range(s) of the content requested
from the document. Following is the general syntax:
The first-byte-pos value in a byte-range-spec gives the byte-offset of the first byte in a
range. The last-byte-pos value gives the byte-offset of the last byte in the range; that is,
the byte positions specified are inclusive. You can specify a byte-unit as bytes Byte
offsets start at zero. Following are a simple examples:
31/49
Multiple ranges can be listed, separated by commas. If the first digit in the comma-
separated byte range(s) is missing, the range is assumed to count from the end of the
document. If the second digit is missing, the range is byte n to the end of the document.
Referer
The Referer request-header field allows the client to specify the address (URI) of the
resource from which the URL has been requested. Following is the general syntax:
Referer: http://www.tutorialspoint.org/http/index.htm
If the field value is a relative URI, it should be interpreted relative to the Request-URI.
TE
TE : t-codings
The presence of the keyword "trailers" indicates that the client is willing to accept trailer
fields in a chunked transfer-coding and it is specified either of the ways:
TE: deflate
TE:
TE: trailers, deflate;q=0.5
User-Agent
The User-Agent request-header field contains information about the user agent
originating the request. Following is the general syntax:
Example:
Accept-Ranges
32/49
The Accept-Ranges response-header field allows the server to indicate its acceptance of
range requests for a resource. Following is the general syntax:
Accept-Ranges: bytes
Servers that do not accept any kind of range request for a resource may send:
Accept-Ranges: none
Age
The Age response-header field conveys the sender's estimate of the amount of time since
the response (or its revalidation) was generated at the origin server. Following is the
general syntax:
Age : delta-seconds
Age values are non-negative decimal integers, representing time in seconds. Following is
a simple example:
Age: 1030
An HTTP/1.1 server that includes a cache must include an Age header field in every
response generated from its own cache.
ETag
The ETag response-header field provides the current value of the entity tag for the
requested variant. Following is the general syntax:
ETag : entity-tag
ETag: "xyzzy"
ETag: W/"xyzzy"
ETag: ""
Location
The Location response-header field is used to redirect the recipient to a location other
than the Request-URI for completion. Following is the general syntax:
Location : absoluteURI
33/49
Location: http://www.tutorialspoint.org/http/index.htm
The Content-Location header field differs from Location in that the Content-Location
identifies the original location of the entity enclosed in the request.
Proxy-Authenticate
Proxy-Authenticate : challenge
Retry-After
The Retry-After response-header field can be used with a 503 (Service Unavailable)
response to indicate how long the service is expected to be unavailable to the requesting
client. Following is the general syntax:
Server
The Server response-header field contains information about the software used by the
origin server to handle the request. Following is the general syntax:
If the response is being forwarded through a proxy, the proxy application must not modify
the Server response-header.
Set-Cookie
34/49
S.N. Options and Description
1 Comment=comment
This option can be used to specify any comment associated with the cookie.
2 Domain=domain
The Domain attribute specifies the domain for which the cookie is valid.
3 Expires=Date-time
The date the cookie will expire. If this is blank, the cookie will expire when the
visitor quits the browser
4 Path=path
The Path attribute specifies the subset of URLs to which this cookie applies.
5 Secure
This instructs the user agent to return the cookie only under a secure
connection.
Vary
The Vary response-header field specifies that the entity has multiple sources and may
therefore vary according to specified list of request header(s). Following is the general
syntax:
Vary : field-name
You can specify multiple headers separated by commas and a value of asterisk "*"
signals that unspecified parameters not limited to the request-headers. Following is a
simple example:
WWW-Authenticate
WWW-Authenticate : challenge
WWW- Authenticate field value as it might contain more than one challenge, or if more
than one WWW-Authenticate header field is provided, the contents of a challenge itself
can contain a comma-separated list of authentication parameters. Following is a simple
example:
35/49
WWW-Authenticate: BASIC realm="Admin"
Entity Headers
Allow
The Allow entity-header field lists the set of methods supported by the resource identified
by the Request-URI. Following is the general syntax:
Allow : Method
You can specify multiple method separated by commas. Following is a simple example:
Content-Encoding
Content-Encoding : content-coding
Content-Encoding: gzip
Content-Language
The Content-Language entity-header field describes the natural language(s) of the
intended audience for the enclosed entity. Following is the general syntax:
Content-Language : language-tag
Multiple languages may be listed for content that is intended for multiple audiences.
Following is a simple example:
Content-Language: mi, en
Content-Length
36/49
The Content-Length entity-header field indicates the size of the entity-body, in decimal
number of OCTETs, sent to the recipient or, in the case of the HEAD method, the size of
the entity-body that would have been sent had the request been a GET. Following is the
general syntax:
Content-Length : DIGITS
Content-Length: 3495
Content-Location
The Content-Location entity-header field may be used to supply the resource location for
the entity enclosed in the message when that entity is accessible from a location separate
from the requested resource's URI. Following is the general syntax:
Content-Location: http://www.tutorialspoint.org/http/index.htm
The value of Content-Location also defines the base URI for the entity.
Content-MD5
The Content-MD5 entity-header field may be used to supply an MD5 digest of the entity,
for checking the integrity of the message upon receipt. Following is the general syntax:
Content-MD5 : md5-digest using base64 of 128 bit MD5 digest as per RFC 1864
Content-MD5 : 8c2d46911f3f5a326455f0ed7a8ed3b3
The MD5 digest is computed based on the content of the entity-body, including any
content-coding that has been applied, but not including any transfer-encoding applied to
the message-body.
Content-Range
The Content-Range entity-header field is sent with a partial entity-body to specify where
in the full entity-body the partial body should be applied. Following is the general syntax:
37/49
- The first 500 bytes:
Content-Range : bytes 0-499/1234
When an HTTP message includes the content of a single range, this content is
transmitted with a Content-Range header, and a Content-Length header showing the
number of bytes actually transferred. For example,
Content-Type
The Content-Type entity-header field indicates the media type of the entity-body sent to
the recipient or, in the case of the HEAD method, the media type that would have been
sent had the request been a GET. Following is the general syntax:
Content-Type : media-type
Following is an example:
Expires
The Expires entity-header field gives the date/time after which the response is considered
stale. Following is the general syntax:
Expires : HTTP-date
Following is an example:
Last-Modified
The Last-Modified entity-header field indicates the date and time at which the origin
server believes the variant was last modified. Following is the general syntax:
Last-Modified: HTTP-date
38/49
Following is an example:
HTTP - Caching
HTTP is typically used for distributed information systems, where performance can be
improved by the use of response caches. The HTTP/1.1 protocol includes a number of
elements intended to make caching work.
The goal of caching in HTTP/1.1 is to eliminate the need to send requests in many cases,
and to eliminate the need to send full responses in many other cases.
The basic cache mechanisms in HTTP/1.1 are implicit directives to caches where server-
specifies expiration times and validators. We use the Cache-Control header for this
purpose.
Cache-control: no-cache
There are following important cache request directives which can be used by the client in
its HTTP request:
1 no-cache
A cache must not use the response to satisfy a subsequent request without
successful revalidation with the origin server.
2 no-store
The cache should not store anything about the client request or server
response.
3 max-age = seconds
Indicates that the client is willing to accept a response whose age is no greater
than the specified time in seconds.
4 max-stale [ = seconds ]
Indicates that the client is willing to accept a response that has exceeded its
expiration time. If seconds are given, it must not be expired by more than that
time.
5 min-fresh = seconds
Indicates that the client is willing to accept a response whose freshness lifetime
is no less than its current age plus the specified time in seconds.
6 no-transform
Do not convert the entity-body.
39/49
7 only-if-cached
Do not retrieve new data. The cache can send a document only if it is in the
cache, and should not contact the origin-server to see if a newer copy exists.
There are following important cache response directives which can be used by the server
in its HTTP response:
1 public
Indicates that the response may be cached by any cache.
2 private
Indicates that all or part of the response message is intended for a single user
and must not be cached by a shared cache.
3 no-cache
A cache must not use the response to satisfy a subsequent request without
successful revalidation with the origin server.
4 no-store
The cache should not store anything about the client request or server
response.
5 no-transform
Do not convert the entity-body.
6 must-revalidate
The cache must verify the status of stale documents before using it and expired
one should not be used.
7 proxy-revalidate
The proxy-revalidate directive has the same meaning as the must- revalidate
directive, except that it does not apply to non-shared user agent caches.
8 max-age = seconds
Indicates that the client is willing to accept a response whose age is no greater
than the specified time in seconds.
9 s-maxage = seconds
The maximum age specified by this directive overrides the maximum age
specified by either the max-age directive or the Expires header. The s-maxage
directive is always ignored by a private cache.
Following table shows ASCII symbol of the character and its equal Symbol and finally its
replacement which can be used in URL before passing it to the server:
40/49
ASCII Symbol Replacement
32 space + or %20
33 ! %21
34 " %22
35 # %23
36 $ %24
37 % %25
38 & %26
39 ' %27
40 ( %28
41 ) %29
42 * *
43 + %2B
44 , %2C
45 - -
46 . .
47 / %2F
48 0 0
49 1 1
50 2 2
51 3 3
52 4 4
53 5 5
54 6 6
55 7 7
56 8 8
57 9 9
41/49
58 : %3A
59 ; %3B
60 < %3C
61 = %3D
62 > %3E
63 ? %3F
64 @ %40
65 A A
66 B B
67 C C
68 D D
69 E E
70 F F
71 G G
72 H H
73 I I
74 J J
75 K K
76 L L
77 M M
78 N N
79 O O
80 P P
81 Q Q
82 R R
83 S S
84 T T
85 U U
42/49
86 V V
87 W W
88 X X
89 Y Y
90 Z Z
91 [ %5B
92 \ %5C
93 ] %5D
94 ^ %5E
95 _ _
96 ` %60
97 a a
98 b b
99 c c
100 d d
101 e e
102 f f
103 g g
104 h h
105 i i
106 j j
107 k k
108 l l
109 m m
110 n n
111 o o
112 p p
113 q q
43/49
114 r r
115 s s
116 t t
117 u u
118 v v
119 w w
120 x x
121 y y
122 z z
123 { %7B
124 | %7C
125 } %7D
126 ~ %7E
127 %7F
> 127 Encode with %xx where xx is the hexadecimal representation of the
character
HTTP - Security
HTTP is used for a communication over the internet, so application developers,
information providers, and users should be aware of the security limitations in HTTP/1.1.
This discussion does not include definitive solutions to the problems mentioned here but it
does make some suggestions for reducing security risks.
All the confidential information should be stored at server side in encrypted form.
Revealing the specific software version of the server might allow the server machine
to become more vulnerable to attacks against software that is known to contain
security holes.
44/49
Proxies which serve as a portal through a network firewall should take special
precautions regarding the transfer of header information that identifies the hosts
behind the firewall.
The information sent in the From field might conflict with the user's privacy interests
or their site's security policy, and hence it should not be transmitted without the user
being able to disable, enable, and modify the contents of the field.
Clients should not include a Referer header field in a (non-secure) HTTP request if
the referring page was transferred with a secure protocol.
Authors of services which use the HTTP protocol should not use GET based forms
for the submission of sensitive data, because this will cause this data to be encoded
in the Request-URI
For example, UNIX, Microsoft Windows, and other operating systems use .. as a path
component to indicate a directory level above the current one. On such a system, an
HTTP server MUST disallow any such construct in the Request-URI if it would otherwise
allow access to a resource outside those intended to be accessible via the HTTP server.
DNS Spoofing
Clients using HTTP rely heavily on the Domain Name Service, and are thus generally
prone to security attacks based on the deliberate mis-association of IP addresses and
DNS names. So clients need to be cautious in assuming the continuing validity of an IP
number/DNS name association.
If HTTP clients cache the results of host name lookups in order to achieve a performance
improvement, they must observe the TTL information reported by DNS. If HTTP clients do
not observe this rule, they could be spoofed when a previously-accessed server's IP
address changes.
Authentication Credentials
45/49
Existing HTTP clients and user agents typically retain authentication information
indefinitely. HTTP/1.1. does not provide a method for a server to direct clients to discard
these cached credentials which is a big security risk.
There are a number of work- arounds to parts of this problem, and so its is recommended
to make the use of password protection in screen savers, idle time-outs, and other
methods which mitigate the security problems inherent in this problem.
Proxy operators should protect the systems on which proxies run as they would protect
any system that contains or transports sensitive information.
Caching proxies provide additional potential vulnerabilities, since the contents of the
cache represent an attractive target for malicious exploitation. Therefore, cache contents
should be protected as sensitive information.
Example 1
HTTP request to fetch hello.htm page from the web server running on tutorialspoint.com
Client request
Server response
46/49
HTTP/1.1 200 OK
Date: Mon, 27 Jul 2009 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Wed, 22 Jul 2009 19:15:56 GMT
Content-Length: 88
Content-Type: text/html
Connection: Closed
<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
Example 2
HTTP request to fetch t.html page which does not exist on the web server running on
tutorialspoint.com
Client request
Server response
Example 3
HTTP request to fetch hello.htm page from the web server running on tutorialspoint.com,
but request goes with wrong HTTP version:
47/49
Client request
Server response
Example 4
HTTP request to post form data to process.cgi CGI page on a web server running on
tutorialspoint.com. Server returns passed name after setting them as cookies:
Client request
first=Zara&last=Ali
Server response
48/49
HTTP/1.1 200 OK
Date: Mon, 27 Jul 2009 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Content-Length: 88
Set-Cookie: first=Zara,last=Ali;domain=tutorialspoint.com;Expires=Mon, 19-
Nov-2010 04:38:14 GMT;Path=/
Content-Type: text/html
Connection: Closed
<html>
<body>
<h1>Hello Zara Ali</h1>
</body>
</html>
Advertisements
49/49