CONTENTS

• NAME
• DESCRIPTION
  • Request
  • Response
  • Use the response in your ActivityPub software
• SEE ALSO

#NAME

MightyNetwork::Doc::WebFinger

#DESCRIPTION

WebFinger is a protocol specified by the IETF for discovery of information about people and things identified by a URI.

WebFinger is not specified in ActivityPub protocol so it’s optional but it’s used by many federated softwares as a de facto standard.

It’s used to fetch actor informations.

#Request

In order to get information about the user foo on the instance bar.org, you need to send a WebFinger request to its instance.

curl https://bar.org/.well-known/webfinger?resource=foo@bar.org

#Response

You will get such a response:

{
    "subject": "acct:foo@bar.org",
    "aliases": [
        "https://bar.org/users/foo"
    ],
    "links": [
        {
            "rel": "self",
            "type": "application/activity+json",
            "href": "https://bar.org/users/foo"
        }
    ]
}

#Use the response in your ActivityPub software

You will use the href content of the link which rel is self to fetch actor’s informations.

curl -H "Accept: application/activity+json" https://bar.org/users/foo

#SEE ALSO

MightyNetwork::Doc