https://en.wikipedia.org/wiki/Uniform_Resource_Identifier

 

"URI" redirects here. For other uses, see  .

In , a Uniform Resource Identifier (URI) is a  of  used to  a .

Such identification enables interaction with representations of the resource over a network, typically the , using specific . Schemes specifying a concrete  and associated protocols define each URI. The most common form of URI is the Uniform Resource Locator (), frequently referred to informally as a web address. More rarely seen in usage is the , which was designed to complement URLs by providing a mechanism for the identification of resources in particular .

Relationship between URI, URL, and URN

A  (URN) may be compared to a person's name, while a  (URL) may be compared to their street address. In other words, a URN identifies an item and a URL provides a method for finding it.

A URL is a URI that, in addition to identifying a web resource, specifies the means of acting upon or obtaining the representation of it, i.e. specifying both its primary access mechanism and network location. For example, the URL http://example.org/wiki/Main_Page refers to a resource identified as /wiki/Main_Page whose representation, in the form of  and related code, is obtainable via the  (http:) from a network host whose  is example.org.

A URN is a URI that identifies a resource by name in a particular namespace. A URN may be used to talk about a resource without implying its location or how to access it. For example, in the  system, ISBN 0-486-27557-4 identifies a specific edition of Shakespeare's play . The URN for that edition would be urn:isbn:0-486-27557-4. To gain access to the book, its location is needed, for which a URL would have to be specified.

Conceptual distinctions

Technical publications, especially standards produced by the  and by the , normally reflect a view outlined in a  of 2001, which acknowledges the precedence of the term URI rather than endorsing any formal subdivision into URL and URN.

“

URL is a useful but informal concept: a URL is a type of URI that identifies a resource via a representation of its primary access mechanism (e.g., its network "location"), rather than by some other attributes it may have.[1]

”

A URL is simply a URI that happens to point to a resource over a network.^[a][2]

However, in non-technical contexts and in software for the World Wide Web, the term URL remains widely used. Additionally, the term web address (which has no formal definition) often occurs in non-technical publications as a synonym for a URI that uses the scheme http or https. Such assumptions can lead to confusion, for example in the case of XML namespaces, which have a visual similarity to resolvable URIs.

While most URI schemes were originally designed to be used with a particular , and often have the same name, they are semantically different from protocols. For example, the scheme http is generally used for interacting with  using HTTP, but the scheme  has no protocol.

Syntax

The syntax of generic URIs and absolute URI references was first defined in  2396, published in August 1998,^[3] and finalized in RFC 3986, published in January 2005.^[4]

A generic URI is of the form:

scheme:[//[user[:password]@]host[:port]][/path][?query][#fragment]

It comprises:

• The scheme, consisting of a sequence of characters beginning with a letter and followed by any combination of letters, digits, plus (+), period (.), or hyphen (-). Although schemes are case-insensitive, the canonical form is lowercase and documents that specify schemes must do so with lowercase letters. It is followed by a colon (:). Examples of popular schemes include , , , , , and . URI schemes should be registered with the , although non-registered schemes are used in practice.^[b]
• Two slashes (//): This is required by some schemes and not required by some others. When the authority component (explained below) is absent, the path component cannot begin with two slashes.^[6]
• An authority part, comprising:
  • An optional  section of a  and , separated by a colon, followed by an at symbol (@)
  • A "host", consisting of either a registered name (including but not limited to a ), or an .  addresses must be in , and  addresses must be enclosed in brackets ([ ]).^[7][c]
  • An optional , separated from the hostname by a colon
• A path, which contains data, usually organized in hierarchical form, that appears as a sequence of segments separated by slashes. Such a sequence may resemble or map exactly to a , but does not always imply a relation to one.^[9] The path must begin with a single slash (/) if an authority part was present, and may also if one was not, but must not begin with a double slash. The path is always defined, though the defined path may be empty (zero length), therefore no trailing slash.

Query delimiter	Example
Ampersand (&)	key1=value1&key2=value2
Semicolon (;)[d][]	key1=value1;key2=value2

• An optional query, separated from the preceding part by a question mark (?), containing a  of non-hierarchical data. Its syntax is not well defined, but by convention is most often a sequence of  separated by a .
• An optional fragment, separated from the preceding part by a  (#). The fragment contains a  providing direction to a secondary resource, such as a section heading in an article identified by the remainder of the URI. When the primary resource is an  document, the fragment is often an  of a specific element, and web browsers will scroll this element into view.

Strings of data  within a URI are represented as characters. Permitted characters within a URI are the  characters for the lowercase and uppercase letters of the modern , the , , , , and .^[11] Octets represented by any other character must be .

Of the ASCII character set, the characters : / ? # [ ] @ are reserved for use as delimiters of the generic URI components and must be percent-encoded — for example, %3F for a question mark.^[12] The characters ! $ & ' ( ) * + , ; =are permitted by generic URI syntax to be used unencoded in the user information, host, and path as delimiters.^[7][13] Additionally, : and @ may appear unencoded within the path, query, and fragment; and ? and / may appear unencoded as data within the query or fragment.^[13][14]

Examples

The following figure displays two example URIs and their component parts.

hierarchical part        ┌───────────────────┴─────────────────────┐                    authority               path        ┌───────────────┴───────────────┐┌───┴────┐  abc://username:password@example.com:123/path/data?key=value&key2=value2#fragid1  └┬┘   └───────┬───────┘ └────┬────┘ └┬┘           └─────────┬─────────┘ └──┬──┘scheme  user information     host     port                  query         fragment  urn:example:mammal:monotreme:echidna  └┬┘ └──────────────┬───────────────┘scheme              path

URI references

A URI reference may take the form of a full URI, the scheme-specific portion of a full URI, a trailing component of a full URI, or the empty string.^[15] An optional fragment identifier, preceded by #, may be present at the end of a URI reference. The part of the reference before the # indirectly identifies a resource, and the fragment identifier identifies some portion of that resource.^[16]

To derive a URI from a URI reference, software converts the URI reference to absolute form by merging it with a base URI according to a fixed algorithm.^[17] The system treats the URI reference as relative to the base URI, although in the case of an absolute reference, the base has no relevance. If the base URI includes a fragment identifier, it is ignored during the merging process.^[17] If a fragment identifier is present in the URI reference, it is preserved during the merging process.^[18]

Web document  frequently use URI references to point to other resources, such as external documents or specific portions of the same logical document.^[19]

Examples in markup languages

• In , the value of the src attribute of the img element provides a URI reference, as does the value of the href attribute of the a or link element.
• In , the  appearing after the SYSTEM keyword in a  is a fragmentless URI reference.
• In , the value of the href attribute of the xsl:importelement/instruction is a URI reference; likewise the first argument to the document() function.

Examples of absolute URIs

• https://example.org/absolute/URI/with/absolute/path/to/resource.txt
• https://example.org/absolute/URI/with/absolute/path/to/resource
• ftp://example.org/resource.txt
• urn::1535-3613

Examples of URI references

• https://example.org/absolute/URI/with/absolute/path/to/resource.txt
• //example.org/scheme-relative/URI/with/absolute/path/to/resource.txt
• //example.org/scheme-relative/URI/with/absolute/path/to/resource
• /relative/URI/with/absolute/path/to/resource.txt
• relative/path/to/resource.txt
• ../../../resource.txt
• ./resource.txt#frag01
• resource.txt
• #frag01

URI resolution

To resolve a URI means either to convert a relative URI reference to absolute form, or to dereference a URI or URI reference, by attempting to obtain a representation of the resource that it identifies.

A same-document reference is a URI reference to a document containing the URI reference itself. A URI reference is defined as a same-document reference if, when resolved to absolute form, it equates exactly to the base URI in effect for the reference.^[19] When encountering a same-document reference, document processing software, for example a web browser, to efficiently use its current representation of a document to satisfy the resolution of a reference to that document without fetching a new representation. URI equivalence is defined as when a URI reference, while not identical to the base URI, still represents the same resource.^[19]

History

Naming, addressing, and identifying resources

URIs and URLs have a shared history. In 1994,  proposals for ^[20] implicitly introduced the idea of a URL as a short string representing a resource that is the target of a . At the time, people referred to it as a "hypertext name"^[21] or "document name".

Over the next three and a half years, as the World Wide Web's core technologies of HTML, HTTP, and web browsers developed, a need to distinguish a string that provided an address for a resource from a string that merely named a resource emerged. Although not yet formally defined, the term Uniform Resource Locatorcame to represent the former, and the more contentious Uniform Resource Namecame to represent the latter.

During the debate over defining URLs and URNs it became evident that the two concepts embodied by the terms were merely aspects of the fundamental, overarching notion of resource identification. In June 1994, the IETF published Berners-Lee's RFC 1630: the first Request for Comments that acknowledged the existence of URLs and URNs, and, more importantly, defined a formal syntax for Universal Resource Identifiers — URL-like strings whose precise syntaxes and semantics depended on their schemes. In addition, this RFC attempted to summarize the syntaxes of URL schemes in use at the time. It also acknowledged, but did not standardize, the existence of relative URLs and fragment identifiers.

Refinement of specifications

In December 1994, RFC 1738 formally defined relative and absolute URLs, refined the general URL syntax, defined how to resolve relative URLs to absolute form, and better enumerated the URL schemes then in use. The agreed definition and syntax of URNs had to wait until the publication of RFC 2141 in May 1997.

The publication of RFC 2396 in August 1998 saw the URI syntax become a separate specification^[3] and most of the parts of RFCs 1630 and 1738 relating to URIs and URLs in general were revised and expanded by the . The new RFC changed the meaning of "U" in "URI" to "Uniform" from "Universal".

In December 1999, RFC 2732 provided a minor update to RFC 2396, allowing URIs to accommodate  addresses. A number of shortcomings discovered in the two specifications led to a community effort, coordinated by RFC 2396 co-author , that culminated in the publication of RFC 3986 in January 2005. While obsoleting the prior standard, it did not render the details of existing URL schemes obsolete; RFC 1738 continues to govern such schemes except where otherwise superseded. RFC 2616 for example, refines the http scheme. Simultaneously, the IETF published the content of RFC 3986 as the full standard STD 66, reflecting the establishment of the URI generic syntax as an official Internet protocol.

In 2001, the W3C's Technical Architecture Group (TAG) published a guide to  and canonical URIs for publishing multiple versions of a given resource.^[22]For example, content might differ by language or by size to adjust for capacity or settings of the device used to access that content.

In August 2002, RFC 3305 pointed out that the term "URL" had, despite widespread public use, faded into near obsolescence, and serves only as a reminder that some URIs act as addresses by having schemes implying network accessibility, regardless of any such actual use. As URI-based standards such as  make evident, resource identification need not suggest the retrieval of resource representations over the Internet, nor need they imply network-based resources at all.

The  uses the HTTP URI scheme to identify both documents and concepts in the real world, a distinction which has caused confusion as to how to distinguish the two. The TAG published an e-mail in 2005 on how to solve the problem, which became known as the httpRange-14 resolution.^[23] The W3C subsequently published an Interest Group Note titled Cool URIs for the Semantic Web,^[24] which explained the use of  and the  response code for redirections in more detail.

Relation to XML namespaces

In , a  is an abstract domain to which a collection of element and attribute names can be assigned. The namespace name is a character string which must adhere to the generic URI syntax.^[25] However, the name is generally not considered to be a URI,^[26] because the URI specification bases the decision not only on lexical components, but also on their intended use. A namespace name does not necessarily imply any of the semantics of URI schemes; for example, a namespace name beginning with http: may have no connotation to the use of the .

Originally, the namespace name could match the syntax of any non-empty URI reference, but the use of relative URI references was deprecated by the W3C.^[27] A separate W3C specification for namespaces in XML 1.1 permits  references to serve as the basis for namespace names in addition to URI references.^[28]