See these use-cases to understand this scenario in context: Peer-review
Initiated by the corresponding author, a repository requests reviews for one of its resources from a trusted review service. More than one review may be made - the offer is not time-limited.
The repository offers the resource for review by the review service.
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
should have an actor
describing the party responsible for initiating this activity
. The actor
:
id
which must be an HTTP URI.type
which should be one of: Application, Group, Organization, Person or Service from AS 2.0.object
This activity
has an object
representing the preprint. The object
has:
id
which is the HTTP URI of the "landing page" for the resource.type
which should include the value AboutPage from schema.org.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.url
containing the details of the actual content resource. The url
has:
id
containing the HTTP URI of the content file for the resource.type
describing the content file.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:
id
which is an HTTP URI identifying the repository.type
which should include the value Service from AS 2.0.inbox
which is the HTTP URI of the LDN inbox for the repositorytarget
The activity
has a target
describing the system which is intended to receive the notification. The target
has:
id
which is an HTTP URI identifying the review-service.type
which should include the value Service from AS 2.0.inbox
which is the HTTP URI of the LDN inbox for the review-service{
"@context": [
"https://www.w3.org/ns/activitystreams",
"https://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"
]
}
The review service notifies the repository of a new review
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 Announce from AS 2.0 and coar-notify:ReviewAction from Notify.
actor
The activity
should have an actor
describing the party responsible for initiating this activity
. The actor
:
id
which must be an HTTP URI.type
which should be one of: Application, Group, Organization, Person or Service from AS 2.0.context
This offer activity
has a context
representing the preprint. The context
has:
id
which is the HTTP URI of the "landing page" for the resource.type
which should include the value AboutPage from schema.org.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.url
containing the details of the actual content resource. The url
has:
id
containing the HTTP URI of the content file for the resource.type
describing the content file.mediaType
which contains the MIME Type of the content file.inReplyTo
inReplyTo
is specified because this is a response to a previous notification. inReplyTo
takes the URI (URN:UUID or HTTP URI) which identifies the activity
for which this is a response.
object
The activity
has an object
representing the review. The object
has:
id
which is the HTTP URI of the "landing page" for the resource.type
which should include the value Document from AS 2.0.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.origin
The activity
has an origin
describing the system which has sent the notification. The origin
has:
id
which is an HTTP URI identifying the review-service.type
which should include the value Service from AS 2.0.inbox
which is the HTTP URI of the LDN inbox for the review-servicetarget
The activity
has a target
describing the system which is intended to receive the notification. The target
has:
id
which is an HTTP URI identifying the repository.type
which should include the value Service from AS 2.0.inbox
which is the HTTP URI of the LDN inbox for the repository{
"@context": [
"https://www.w3.org/ns/activitystreams",
"https://purl.org/coar/notify"
],
"actor": {
"id": "https://isni.org/isni/0000000122832703",
"name": "H G Wells",
"type": "Person"
},
"context": {
"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"
]
}
},
"id": "urn:uuid:94ecae35-dcfd-4182-8550-22c7164fe23f",
"inReplyTo": "urn:uuid:0370c0fb-bb78-4a9b-87f5-bed307a509dd",
"object": {
"id": "https://review-service.com/review/geo/202103/0021",
"ietf:cite-as": "https://doi.org/10.3214/987654",
"type": [
"Document",
"sorg:Review"
]
},
"origin": {
"id": "https://review-service.com/system",
"inbox": "https://review-service.com/system/inbox/",
"type": "Service"
},
"target": {
"id": "https://research-organisation.org/repository",
"inbox": "https://research-organisation.org/repository/inbox/",
"type": "Service"
},
"type": [
"Announce",
"coar-notify:ReviewAction"
]
}
The review service notifies the repository of a new review
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 Announce from AS 2.0 and coar-notify:ReviewAction from Notify.
actor
The activity
should have an actor
describing the party responsible for initiating this activity
. The actor
:
id
which must be an HTTP URI.type
which should be one of: Application, Group, Organization, Person or Service from AS 2.0.context
This offer activity
has a context
representing the preprint. The context
has:
id
which is the HTTP URI of the "landing page" for the resource.type
which should include the value AboutPage from schema.org.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.url
containing the details of the actual content resource. The url
has:
id
containing the HTTP URI of the content file for the resource.type
describing the content file.mediaType
which contains the MIME Type of the content file.inReplyTo
inReplyTo
is specified because this is a response to a previous notification. inReplyTo
takes the URI (URN:UUID or HTTP URI) which identifies the activity
for which this is a response.
object
The activity
has an object
representing the review. The object
has:
id
which is the HTTP URI of the "landing page" for the resource.type
which should include the value Document from AS 2.0.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.origin
The activity
has an origin
describing the system which has sent the notification. The origin
has:
id
which is an HTTP URI identifying the review-service.type
which should include the value Service from AS 2.0.inbox
which is the HTTP URI of the LDN inbox for the review-servicetarget
The activity
has a target
describing the system which is intended to receive the notification. The target
has:
id
which is an HTTP URI identifying the repository.type
which should include the value Service from AS 2.0.inbox
which is the HTTP URI of the LDN inbox for the repository{
"@context": [
"https://www.w3.org/ns/activitystreams",
"https://purl.org/coar/notify"
],
"actor": {
"id": "https://isni:org/isni/00000001214005623",
"name": "Jules Verne",
"type": "Person"
},
"context": {
"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"
]
}
},
"id": "urn:uuid:d4ed8e1d-d6ce-4160-9f84-2546a72376a1",
"inReplyTo": "urn:uuid:0370c0fb-bb78-4a9b-87f5-bed307a509dd",
"object": {
"id": "https://review-service.com/review/geo/202103/0021",
"ietf:cite-as": "https://doi.org/10.3214/987654",
"type": [
"Document",
"sorg:Review"
]
},
"origin": {
"id": "https://review-service.com/system",
"inbox": "https://review-service.com/system/inbox/",
"type": "Service"
},
"target": {
"id": "https://research-organisation.org/repository",
"inbox": "https://research-organisation.org/repository/inbox/",
"type": "Service"
},
"type": [
"Announce",
"coar-notify:ReviewAction"
]
}