<p><em>Note: This document has been superseded by &rfc4622;.</em></p>
<p>It is widely acknowledged that it would be good to be able to express a Jabber Identifier (JID) (see &xep0029;) as a Uniform Resource Identifier (see &rfc3986;). In addition, there would be value in being able to interact with a JID through a URI scheme (e.g., by sending a message or a presence update).</p>
<p>Although XMPP enables a wide range of functionality, the authors propose that a Jabber URI scheme needs to support only a limited subset of the possible Jabber functionality. In particular, we see the following as core functions that need to be supported:</p>
<ul>
<li>Sending of basic messages</li>
<li>Sending of basic presence</li>
<li>Sending of subscription requests</li>
</ul>
</section1>
<section1topic='Syntax'>
<p>The syntactic components of a Jabber URI are as follows:</p>
<p>This scheme is similar to the mailto URI scheme <note>The mailto URI scheme is described in RFC 2368: <linkurl='http://www.ietf.org/rfc/rfc2368.txt'>http://www.ietf.org/rfc/rfc2368.txt</link>.</note>. One similarity is that a Jabber URI is, in the terminology of RFC 3986, not hierarchical but opaque. A URI that is hierarchical in nature uses the slash ("/") character in order to separate hierarchical components, as is familiar from HTTP and FTP URIs. By contrast, an opaque URI such as a mailto URI contains only the scheme (e.g., 'mailto'), a colon, an address (e.g., 'user@host'), and an optional query component.</p>
<p>Per the JID definition in XEP-0029, the node identifier is optional (i.e., a mere domain identifier is a valid JID). However, the proposed Jabber URI scheme forbids the inclusion of a resource identifier in the JID, even though XEP-0029 defines this as valid. This is partly because the authors see no compelling reason to include a resource identifier in the Jabber URI scheme, and also because including a resource would necessitate the inclusion of a slash character in an opaque URI, which is contrary to RFC 3986. Finally, the query component is optional.</p>
<section1topic='URI Characters and Escape Sequences'>
<p>RFC 3986 limits the characters included in a URI to US-ASCII characters, and further defines a number of US-ASCII characters as reserved or otherwise excluded. Reserved characters are special characters used as delimiters withing URIs and whose usage is limited to their reserved purpose as defined in RFC 3986 or a specific URI scheme. Excluded characters are control characters, spaces, and other common (non-URI-specific) delimiters such as angle brackets, double quotes, the number sign, and the percent sign. Reserved characters must be escaped if their usage in a specific context would conflict with their reserved purpose, and excluded characters must always be escaped. The set of disallowed charaacters for any specific URI component consists of the reserved and excluded characters for that component. These are defined below for each component of a Jabber URI.</p>
<section2topic='Scheme Component'>
<p>The scheme component for a Jabber URI is 'xmpp'. This component is delimited from the remainder of the URI by a colon character (':').</p>
<p>The node identifier component of a Jabber URI is equivalent to the "userinfo" component of a generic URI. Section 2.3 of XEP-0029 stipulates that a node identifier may contain any Unicode character higher than #x20 with the exception of the following:</p>
<p>Section 2.4.3 of RFC 3986 further stipulates that the following characters are excluded from URIs in their unescaped form:</p>
<code>#x23 (#) | #x25 (%)</code>
<p>Finally, because the generic URI syntax does not provide a way to specify a character encoding other than US-ASCII (see Section 2.1 of RFC 3986), the characters in the node identifier component of a Jabber URI must contain only US-ASCII characters.</p>
<p>Therefore, in order to ensure that a Jabber URI containing a node identifier is a valid URI, the characters disallowed by RFC 3986 (reserved, excluded, and non-ASCII characters) must be escaped in the node identifier component of a Jabber URI.</p>
</section2>
<section2topic='Domain Identifier Component'>
<p>A domain identifier is a standard DNS hostname as specified in RFC 952 <note><linkurl='http://www.ietf.org/rfc/rfc952.txt'>http://www.ietf.org/rfc/rfc952.txt</link></note>.</p>
</section2>
<section2topic='Query Component'>
<p>The query component of a Jabber URI may contain any US-ASCII character higher than #x20 with the exception of the following:</p>
<code>#x22 (") | #x23 (#) | #x24 ($) | #x25 (%) |
#x26 (&) | #x27 (') | #x2B (+) | #x2C (,) |
#x2F (/) | #x3A (:) | #x3B (;) | #x3C (<) |
#x3D (=) | #x3E (>) | #x3F (?) | #x40 (@) |
#x7F (del) | #xFFFE (BOM) | #xFFFF (BOM)</code>
</section2>
</section1>
<section1topic='Use Cases'>
<p>Thus the most basic Jabber URI is user@host (sometimes referred to as a "bare JID") prepended by 'xmpp:', as shown in the following example.</p>
<code>
xmpp:user@host
</code>
<p>A URI containing bare JID and no query component should trigger an application to present a user with an appropriate interface to complete an action such as sending a message, sending presence, or managing a subscription. In order to make this possible, some basic queries must be included in the protocol.</p>
<p>The authors propose three allowable query types in a Jabber URI: message, presence, and subscribe <note>These query types are URI queries as defined in RFC 3986 and are not to be confused with the <query/> element often included as the child of an <iq/> element in XMPP.</note>. These three basic URIs are described below by way of use cases.</p>
<section2topic='Sending a Message'>
<p>If no parameters are passed along with the message query type, an application should present a user with an appropriate interface to complete the sending of a message.</p>
<examplecaption='Invoking an Interface to Send a Message to a JID'>
xmpp:user@host?message
</example>
<p>The query component may include parameters that further specify the message to be sent to the intended recipient. The following parameters are allowed:</p>
<ul>
<li>body</li>
<li>subject</li>
<li>thread (for conversation tracking)</li>
</ul>
<examplecaption='Sending a Message with a Subject, Body, and Thread'>
<p>If no parameters are passed along with the presence query type, an application should present a user with an appropriate interface to complete the act of sending presence.</p>
<examplecaption='Invoking an Interface to Send Presence to a JID'>
xmpp:user@host?presence
</example>
<p>The query component may include parameters that further specify the presence to be sent to the intended recipient (e.g., a user-defined status message). The following parameters are allowed:</p>
<ul>
<li>type ('unavailable'; if not specified, the sender is defined to be online and available)</li>
<li>show (one of 'away', 'xa', 'dnd', or 'chat')</li>
<li>status (user-defined status message)</li>
<li>priority (a non-negative integer, with zero as the lowest priority)</li>
<p>If no parameters are passed along with the subscribe query type, an application should present a user with an appropriate interface to complete the subscription request.</p>
<examplecaption='Invoking an Interface to Send a Subscription Request to a JID'>
xmpp:user@host?subscribe
</example>
<p>The query component may include parameters that further specify the subscription request to be sent to the intended recipient. Only the 'type' parameter is deemed useful in the limited Jabber URI spec, with valid values of 'subscribe', 'subscribed', 'unsubscribe', or 'unsubscribed'.</p>
<examplecaption='Sending a Subscription Request'>
xmpp:user@host?subscribe&type=subscribe
</example>
<examplecaption='Accepting a Subscription Request'>
xmpp:user@host?subscribe&type=subscribed
</example>
<examplecaption="Unsubscribing from Another User's Presence">
xmpp:user@host?subscribe&type=unsubscribe
</example>
<examplecaption="Cancelling Another User's Subscription to Your Presence">
