Linkbacks and Website Communication - part 5


In the webmention linkback, the linking site is responsible to inform the linked site about the linking document.

When a new document is added or exising document is updated, the linking site should extracts all the links in the document. For each link it finds in document, the linking site should find the webmention URL and send notification request to the linked site about the linking document.

The linking site request

The linking site should send standard HTTP POST request to webmention URL. The request must contains the following fields:

  • source - The linking document URL
  • target - The linked document URL

The linking site response

The response should response as described in spec

The webmention URL autodiscovery

There are 3 ways the linked site announce about its interest in webmention notification:

  • Add Link HTTP Header to document response with the value of webmention URL
    webmention - http header
     HTTP/1.1 200 OK
     Link: <document webmention URL>
  • Embed a webmention URL link in the document's header
    webmention - link tag
     <link href="<webmention URL>" rel="webmention">
  • Embed webmention URL link in the document's body
    webmention - a tag
     <a href="<webmention URL>" rel="webmention" />
  • The linking site should download the linked document and scan for webmention URL.