discovery-api/Overview.html
author Dominique Hazael-Massieux <dom@w3.org>
Wed, 11 Jan 2017 10:30:32 +0100
changeset 594 ffb713303c21
parent 492 2f37e8af951a
permissions -rw-r--r--
Shelve Network Service Discovery API

per https://lists.w3.org/Archives/Public/public-device-apis/2017Jan/0000.html
<!DOCTYPE html>
<html dir="ltr" typeof="bibo:Document " prefix="bibo: http://purl.org/ontology/bibo/ w3p: http://www.w3.org/2001/02pd/rec54#" lang="en">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
  <meta property="dc:language" content="en" lang="">
  <style>
    /*

github.com style (c) Vasily Polovnyov <vast@whiteants.net>

*/
    
    .hljs {
      display: block;
      overflow-x: auto;
      padding: 0.5em;
      color: #333;
      background: #f8f8f8;
    }
    
    .hljs-comment,
    .hljs-quote {
      color: #998;
      font-style: italic;
    }
    
    .hljs-keyword,
    .hljs-selector-tag,
    .hljs-subst {
      color: #333;
      font-weight: bold;
    }
    
    .hljs-number,
    .hljs-literal,
    .hljs-variable,
    .hljs-template-variable,
    .hljs-tag .hljs-attr {
      color: #008080;
    }
    
    .hljs-string,
    .hljs-doctag {
      color: #d14;
    }
    
    .hljs-title,
    .hljs-section,
    .hljs-selector-id {
      color: #900;
      font-weight: bold;
    }
    
    .hljs-subst {
      font-weight: normal;
    }
    
    .hljs-type,
    .hljs-class .hljs-title {
      color: #458;
      font-weight: bold;
    }
    
    .hljs-tag,
    .hljs-name,
    .hljs-attribute {
      color: #000080;
      font-weight: normal;
    }
    
    .hljs-regexp,
    .hljs-link {
      color: #009926;
    }
    
    .hljs-symbol,
    .hljs-bullet {
      color: #990073;
    }
    
    .hljs-built_in,
    .hljs-builtin-name {
      color: #0086b3;
    }
    
    .hljs-meta {
      color: #999;
      font-weight: bold;
    }
    
    .hljs-deletion {
      background: #fdd;
    }
    
    .hljs-addition {
      background: #dfd;
    }
    
    .hljs-emphasis {
      font-style: italic;
    }
    
    .hljs-strong {
      font-weight: bold;
    }
  </style>
  <style id="respec-mainstyle">
    /*****************************************************************
 * ReSpec 3 CSS
 * Robin Berjon - http://berjon.com/
 *****************************************************************/
    /* Override code highlighter background */
    
    .hljs {
      background: transparent !important;
    }
    /* --- INLINES --- */
    
    em.rfc2119 {
      text-transform: lowercase;
      font-variant: small-caps;
      font-style: normal;
      color: #900;
    }
    
    h1 acronym,
    h2 acronym,
    h3 acronym,
    h4 acronym,
    h5 acronym,
    h6 acronym,
    a acronym,
    h1 abbr,
    h2 abbr,
    h3 abbr,
    h4 abbr,
    h5 abbr,
    h6 abbr,
    a abbr {
      border: none;
    }
    
    dfn {
      font-weight: bold;
    }
    
    a.internalDFN {
      color: inherit;
      border-bottom: 1px solid #99c;
      text-decoration: none;
    }
    
    a.externalDFN {
      color: inherit;
      border-bottom: 1px dotted #ccc;
      text-decoration: none;
    }
    
    a.bibref {
      text-decoration: none;
    }
    
    cite .bibref {
      font-style: normal;
    }
    
    code {
      color: #C83500;
    }
    
    th code {
      color: inherit;
    }
    /* --- TOC --- */
    
    .toc a,
    .tof a {
      text-decoration: none;
    }
    
    a .secno,
    a .figno {
      color: #000;
    }
    
    ul.tof,
    ol.tof {
      list-style: none outside none;
    }
    
    .caption {
      margin-top: 0.5em;
      font-style: italic;
    }
    /* --- TABLE --- */
    
    table.simple {
      border-spacing: 0;
      border-collapse: collapse;
      border-bottom: 3px solid #005a9c;
    }
    
    .simple th {
      background: #005a9c;
      color: #fff;
      padding: 3px 5px;
      text-align: left;
    }
    
    .simple th[scope="row"] {
      background: inherit;
      color: inherit;
      border-top: 1px solid #ddd;
    }
    
    .simple td {
      padding: 3px 10px;
      border-top: 1px solid #ddd;
    }
    
    .simple tr:nth-child(even) {
      background: #f0f6ff;
    }
    /* --- DL --- */
    
    .section dd>p:first-child {
      margin-top: 0;
    }
    
    .section dd>p:last-child {
      margin-bottom: 0;
    }
    
    .section dd {
      margin-bottom: 1em;
    }
    
    .section dl.attrs dd,
    .section dl.eldef dd {
      margin-bottom: 0;
    }
    
    .respec-hidden {
      display: none;
    }
    
    #respec-ui {
      position: fixed;
      top: 20px;
      right: 20px;
      width: 202px;
      text-align: right;
    }
    
    #respec-pill,
    .respec-info-button {
      background: #fff;
      height: 2.5em;
      color: rgb(120, 120, 120);
      border: 1px solid #ccc;
      box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, .5);
    }
    
    .respec-info-button {
      border: none;
      border-radius: 2em;
      margin-right: 1em;
      min-width: 3.5em;
    }
    
    #respec-pill:disabled {
      margin: 10px auto;
      font-size: 2.8px;
      position: relative;
      text-indent: -9999em;
      border-top: 1.1em solid rgba(40, 40, 40, 0.2);
      border-right: 1.1em solid rgba(40, 40, 40, 0.2);
      border-bottom: 1.1em solid rgba(40, 40, 40, 0.2);
      border-left: 1.1em solid #ffffff;
      transform: translateZ(0);
      animation: respec-spin 1.1s infinite linear;
      box-shadow: none;
    }
    
    #respec-pill:disabled,
    #respec-pill:disabled:after {
      border-radius: 50%;
      width: 10em;
      height: 10em;
    }
    
    @keyframes respec-spin {
      0% {
        transform: rotate(0deg);
      }
      100% {
        transform: rotate(360deg);
      }
    }
    
    #respec-pill:hover,
    #respec-pill:focus {
      color: rgb(0, 0, 0);
      transition: color .2s
    }
    
    #respec-menu {
      font-family: sans-serif;
      background: #fff;
      box-shadow: 1px 1px 8px 0 rgba(100, 100, 100, .5);
      width: 200px;
      display: none;
      text-align: left;
      margin-top: 5px;
      font-size: .8em;
    }
    
    .respec-save-button {
      background: #fff;
      border: 1px solid #000;
      border-radius: 5px;
      padding: 5px;
      margin: 5px;
      display: block;
      width: 100%;
      color: #000;
      text-decoration: none;
      text-align: center;
      font-size: inherit;
    }
    
    #respec-ui button:focus,
    #respec-pill:focus,
    .respec-option:focus {
      outline: 0;
      outline-style: none;
    }
    
    #respec-ui button.respec-pill-error {
      background-color: red;
      color: white;
    }
    
    #respec-ui button.respec-pill-warning {
      background-color: orange;
      color: white;
    }
    
    #respec-menu button.respec-option {
      background: white;
      border: none;
      width: 100%;
      text-align: left;
      font-size: inherit;
      padding: 1.2em 1.2em;
    }
    
    #respec-menu button.respec-option:hover {
      background-color: #eeeeee;
    }
    
    .respec-cmd-icon {
      padding-right: .5em;
    }
    
    #respec-ui button.respec-option:last-child {
      border: none;
      border-radius: inherit;
    }
    
    .respec-offending-element {
      display: inline-block;
      position: relative;
      background: url(data:image/gif;base64,R0lGODdhBAADAPEAANv///8AAP///wAAACwAAAAABAADAEACBZQjmIAFADs=) bottom repeat-x;
    }
    
    @media print {
      .removeOnSave {
        display: none;
      }
    }
  </style>
  <title>
    Network Service Discovery
  </title>



  <style>
    /* Custom ReSpec CSS (by Rich Tibbett) */
    /* Add better spacing to sections */
    
    section,
    .section {
      margin-bottom: 2em;
    }
    /* Add addition spacing to <ol> and <ul> for rule definition */
    
    ol.rule li,
    ul.rule li {
      padding: 0.6em;
    }
    
    pre.widl {
      border: solid thin;
      background: #EEEEEE;
      color: black;
      padding: 0.5em 1em;
      position: relative;
    }
    
    pre.widl :link,
    pre.widl :visited {
      color: #000;
      background: transparent;
    }
    
    pre.widl:before {
      content: "IDL";
      font: bold small sans-serif;
      padding: 0.5em;
      background: white;
      position: absolute;
      top: 0;
      margin: -1px 0 0 -4em;
      width: 1.5em;
      border: thin solid;
      border-radius: 0 0 0 0.5em
    }
    
    div.example {
      border: solid thin black;
      background: #FFFFF0;
      color: black;
      padding: 0.5em 1em;
      position: relative;
      margin: 1em 0 1em 4.6em;
      width: auto;
    }
    
    div.example:before {
      content: "EXAMPLE";
      font: bold small sans-serif;
      padding: 0.5em;
      background: white;
      color: black;
      position: absolute;
      top: 0;
      margin: -1px 0 0 -7.6em;
      width: 5em;
      border: thin solid black;
      border-radius: 0 0 0 0.5em
    }
    
    dl.domintro {
      color: green;
      margin: 2em 0 2em 2em;
      padding: 0.5em 1em;
      border: none;
      background: #DDFFDD;
    }
    
    hr+dl.domintro,
    div.impl+dl.domintro {
      margin-top: 2.5em;
      margin-bottom: 1.5em;
    }
    
    dl.domintro dt,
    dl.domintro dt * {
      color: black;
      text-decoration: none;
    }
    
    dl.domintro dd {
      margin: 0.5em 0 1em 2em;
      padding: 0;
    }
    
    dl.domintro dd p {
      margin: 0.5em 0;
    }
    
    dl.domintro code {
      font-size: inherit;
      font-style: italic;
    }
    
    dl.domintro:before {
      display: table;
      margin: -1em -0.5em 0.5em auto;
      width: auto;
      content: 'This box is non-normative. Implementation requirements are given below this box.';
      color: red;
      border: solid 2px;
      background: white;
      padding: 0 0.25em;
      font-size: 0.8em;
    }
    
    table {
      border-collapse: collapse;
      border-style: hidden hidden none hidden
    }
    
    table thead {
      border-bottom: solid
    }
    
    table tbody th:first-child {
      border-left: solid
    }
    
    table td,
    table th {
      border-left: solid;
      border-right: solid;
      border-bottom: solid thin;
      vertical-align: top;
      padding: 0.2em
    }
  </style>

  <!--[if lt IE 9]><script src='https://www.w3.org/2008/site/js/html5shiv.js'></script><![endif]-->
  <script id="initialUserConfig" type="application/json">
    {
      "specStatus": "WG-NOTE",
      "shortName": "discovery-api",
      "edDraftURI": "http://dvcs.w3.org/hg/dap/raw-file/tip/discovery-api/Overview.html",
      "previousMaturity": "WD",
      "previousPublishDate": "2014-02-20",
      "editors": [
      {
        "name": "Rich Tibbett",
        "company": "Opera Software ASA",
        "companyURL": "http://opera.com/"
      }],
      "wg": "Device and Sensors Working Group",
      "wgURI": "https://www.w3.org/2009/dap/",
      "wgPublicList": "public-device-apis",
      "wgPatentURI": "https://www.w3.org/2004/01/pp-impl/43696/status",
      "noIDLIn": true,
      "publishDate": "2017-01-12"
    }
  </script>
  <link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/2016/W3C-WG-NOTE.css">
  <meta name="generator" content="ReSpec 8.4.1">
  <link rel="canonical" href="https://www.w3.org/TR/discovery-api/">
</head>
<body class="h-entry" role="document" id="respecDocument">
  <div class="head" role="contentinfo" id="respecHeader">
    <p>
      <a class="logo" href="https://www.w3.org/"><img src="https://www.w3.org/StyleSheets/TR/2016/logos/W3C" alt="W3C" width="72" height="48"></a>
    </p>
    <h1 class="title p-name" id="title" property="dcterms:title">Network Service Discovery</h1>
    <h2 id="w3c-working-group-note-12-january-2017"><abbr title="World Wide Web Consortium">W3C</abbr> Working Group Note <time property="dcterms:issued" class="dt-published" datetime="2017-01-12">12 January 2017</time></h2>
    <dl>
      <dt>This version:</dt>
      <dd><a class="u-url" href="https://www.w3.org/TR/2017/NOTE-discovery-api-20170112/">https://www.w3.org/TR/2017/NOTE-discovery-api-20170112/</a></dd>
      <dt>Latest published version:</dt>
      <dd><a href="https://www.w3.org/TR/discovery-api/">https://www.w3.org/TR/discovery-api/</a></dd>
      <dt>Latest editor's draft:</dt>
      <dd><a href="http://dvcs.w3.org/hg/dap/raw-file/tip/discovery-api/Overview.html">http://dvcs.w3.org/hg/dap/raw-file/tip/discovery-api/Overview.html</a></dd>
      <dt>Previous version:</dt>
      <dd><a rel="dcterms:replaces" href="https://www.w3.org/TR/2014/WD-discovery-api-20140220/">https://www.w3.org/TR/2014/WD-discovery-api-20140220/</a></dd>
      <dt>Editor:</dt>
      <dd class="p-author h-card vcard" property="bibo:editor" resource="_:editor0"><span property="rdf:first" typeof="foaf:Person"><span property="foaf:name" class="p-name fn">Rich Tibbett</span>, <a property="foaf:workplaceHomepage" class="p-org org h-org h-card" href="http://opera.com/">Opera Software ASA</a></span>
        <span property="rdf:rest" resource="rdf:nil"></span>
      </dd>

    </dl>
    <p class="copyright">
      <a href="https://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2017

      <a href="https://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="https://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>,
      <a href="https://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>,
      <a href="https://www.keio.ac.jp/">Keio</a>, <a href="http://ev.buaa.edu.cn/">Beihang</a>).
      <abbr title="World Wide Web Consortium">W3C</abbr> <a href="https://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
      <a href="https://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and
      <a rel="license" href="https://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.
    </p>
    <hr title="Separator for header">
  </div>

  <section id="abstract" class="introductory" property="dc:abstract">
    <h2 id="h-abstract" resource="#h-abstract"><span property="xhv:role" resource="xhv:heading">Abstract</span></h2>
    <p>
      This specification defines a mechanism for an HTML document to discover and subsequently communicate with
      <abbr title="Hypertext Transfer Protocol">HTTP</abbr>-based services advertised via common discovery protocols within the current network.
    </p>
  </section>

  <section id="sotd" class="introductory">
    <h2 id="h-sotd" resource="#h-sotd"><span property="xhv:role" resource="xhv:heading">Status of This Document</span></h2>
    <p>
      <em>This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current <abbr title="World Wide Web Consortium">W3C</abbr> publications and the latest revision of this technical report can be found in the <a href="https://www.w3.org/TR/"><abbr title="World Wide Web Consortium">W3C</abbr> technical reports index</a> at https://www.w3.org/TR/.</em>
    </p>

    <p>
      <strong>Work on this document has been discontinued and it should not be referenced or used as a basis for implementation.</strong> The <a href="https://www.w3.org/TR/presentation-api/">Presentation API</a> and the <a href="https://www.w3.org/TR/remote-playback/">Remote Playback API</a> address a subset of the use cases this API attempted to address.
    </p>

    <p>
      This document was published by the <a href="https://www.w3.org/2009/dap/">Device and Sensors Working Group</a> as a Working Group Note. If you wish to make comments regarding this document, please send them to
      <a href="mailto:public-device-apis@w3.org">public-device-apis@w3.org</a> (<a href="mailto:public-device-apis-request@w3.org?subject=subscribe">subscribe</a>,
      <a href="https://lists.w3.org/Archives/Public/public-device-apis/">archives</a>). All comments are welcome.
    </p>
    <p>
      Publication as a Working Group Note does not imply endorsement by the <abbr title="World Wide Web Consortium">W3C</abbr> Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.
    </p>
    <p>
      This document was produced by a group operating under the
      <a id="sotd_patent" property="w3p:patentRules" href="https://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 <abbr title="World Wide Web Consortium">W3C</abbr> Patent
              Policy</a>.
      <abbr title="World Wide Web Consortium">W3C</abbr> maintains a <a href="https://www.w3.org/2004/01/pp-impl/43696/status" rel="disclosure">public list of any patent
                disclosures</a> made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains
      <a href="https://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential
              Claim(s)</a> must disclose the information in accordance with
      <a href="https://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section
              6 of the <abbr title="World Wide Web Consortium">W3C</abbr> Patent Policy</a>.
    </p>
    <p>This document is governed by the <a id="w3c_process_revision" href="https://www.w3.org/2015/Process-20150901/">1 September 2015 <abbr title="World Wide Web Consortium">W3C</abbr> Process Document</a>.
    </p>

  </section>



  <style>
    a.externalDFN {
      color: #00C;
      border-bottom: 1px dashed #00C;
    }
    
    a.internalDFN {
      color: #00C;
      text-decoration: solid;
    }
  </style>
  <script src="https://www.w3.org/scripts/TR/2016/fixup.js"></script>
</body>
</html>