Request Review

(This is a Notify notification from the Repository requests review (on behalf of corresponding author) scenario, using the Offer of a resource to a service notification pattern).

The repository requests a review from the review service.

Properties

The @context must include:

id

Notify notifications must describe an AS 2.0 activity. The activity has an id which must be a URI, and the use of URN:UUID is recommended. An HTTP URI may be used instead, but in such cases the URI should resolve to a useful resource.

type

The activity has a type which should include at least Offer from AS 2.0 and coar-notify:ReviewAction from Notify.

actor

The activity MUST have an actor describing the party responsible for initiating this activity. The actor:

  • has an id which must be an HTTP URI.
  • has a type which should be one of: Application, Group, Organization, Person or Service from AS 2.0.
  • may have a name

object

This activity has an object representing the preprint. The object has:

  • An id which is the HTTP URI of the "landing page" for the resource.
  • A type which should include the value AboutPage from schema.org.
  • An ietf:cite-as which contains the persistent HTTP URI (sometimes called the "PID") which is to be used to cite or link to the resource.
  • A url containing the details of the actual content resource. The url has:
    • An id containing the HTTP URI of the content file for the resource.
    • A type describing the content file.
    • A mediaType which contains the MIME Type of the content file.

origin

The activity has an origin describing the system which has sent the notification. The origin has:

  • An id which is an HTTP URI identifying the repository.
  • A type which should include the value Service from AS 2.0.
  • An inbox which is the HTTP URI of the LDN inbox for the repository

target

The activity has a target describing the system which is intended to receive the notification. The target has:

  • An id which is an HTTP URI identifying the review-service.
  • A type which should include the value Service from AS 2.0.
  • An inbox which is the HTTP URI of the LDN inbox for the review-service

Example JSON-LD Payload

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "http://purl.org/coar/notify"
  ],
  "actor": {
    "id": "https://orcid.org/0000-0002-1825-0097",
    "name": "Josiah Carberry",
    "type": "Person"
  },
  "id": "urn:uuid:0370c0fb-bb78-4a9b-87f5-bed307a509dd",
  "object": {
    "id": "https://research-organisation.org/repository/preprint/201203/421/",
    "ietf:cite-as": "https://doi.org/10.5555/12345680",
    "type": "sorg:AboutPage",
    "url": {
      "id": "https://research-organisation.org/repository/preprint/201203/421/content.pdf",
      "media-type": "application/pdf",
      "type": [
        "Article",
        "sorg:ScholarlyArticle"
      ]
    }
  },
  "origin": {
    "id": "https://research-organisation.org/repository",
    "inbox": "https://research-organisation.org/repository/inbox/",
    "type": "Service"
  },
  "target": {
    "id": "https://review-service.com/system",
    "inbox": "https://review-service.com/system/inbox/",
    "type": "Service"
  },
  "type": [
    "Offer",
    "coar-notify:ReviewAction"
  ]
}