MightyNetwork :: Doc :: ActivityPub :: Activity :: Announce (source, CPAN)

#NAME

MightyNetwork::Doc::ActivityPub::Activity::Announce

#DESCRIPTION

Activity indicating that the actor is calling the target's attention the object.

It’s used in Mastodon to boost (share, retweet if you prefer) a toot. For this case, as JSON-LD signatures’ usage is decreasing due to a lack of libraries for all languages, to ensure the veracity of the announced object, you should fetch it from its server of origin, not trust the object contained in the Announce.

See https://www.w3.org/TR/activitystreams-vocabulary/#dfn-announce for details.

#ACTOR

Activity’s actor refer to the actor who makes the action.

#OBJECT

Activity’s object refer to the object that is the subject of the action.

See https://www.w3.org/TR/activitystreams-vocabulary/#h-object-types for available objects.

#SUMMARY

Example: https://example.org/users/narf Announce she had arrived at Work (which is a Place object).

#JSON-LD REPRESENTATION

For our example above, the activity would be like this.

{
  "@context": "https://www.w3.org/ns/activitystreams",
  "summary": "Narf announced that she had arrived at work",
  "type": "Announce",
  "actor": {
    "type": "Person",
    "id": "https://example.org/users/narf",
    "name": "Narf"
  },
  "object": {
    "type": "Arrive",
    "actor": "https://example.org/users/narf",
    "location": {
      "type": "Place",
      "name": "Work"
    }
  }
}

CONTENTS