subhub/handlers/webfinder
inhosin d6387c3528 some fix 2019-09-19 10:14:22 +03:00
..
README.md add some works 2019-09-07 17:54:53 +03:00
address.go add some works 2019-09-07 17:54:53 +03:00
models.go add some works 2019-09-07 17:54:53 +03:00
webfinger.go some fix 2019-09-19 10:14:22 +03:00

README.md

What's Webfinger?

Webfinger, a protocol for discovering objects on the server. It's used by Mastodon and is important for interop'ing with Mastodon (and most ActivityPub servers).

It lives at a special route: GET /.well-known/webfinger.

We can expect a webfinger response to always looks something like this:

{
  "subject": "acct:alice@my-example.com",

  "links": [
    {
      "rel": "self",
      "type": "application/activity+json",
      "href": "https://my-example.com/actor"
    }
  ]
}

In this case, alice is the ActivityPub Organization slug, and my-example.com is the domain of the server.