D4Science D4Science Don't have a D4Science account? Create one Could not find what you are looking for? Contact us.

Notifications Resource

REST interface for the social networking library (notifications).

POST /2/notifications/catalogue

Send a Catalogue notification to a given user

Request Parameters
name type description
Authorization header Bearer token, see https://dev.d4science.org/how-to-access-resources
Content-Type header application/json
Request Body
media type data type
application/json CatalogueEvent (JSON)
Response Codes
code condition
200 Catalogue Notification is sent correctly
500 The error is reported into the 'message' field of the returned object
Response Body
media type data type description
application/json object (JSON)

Example

Request
POST /2/notifications/catalogue
Content-Type: application/json
Accept: application/json
Authorization: ...

                
{
  "idsToNotify" : [ "...", "..." ],
  "notifyText" : "...",
  "itemURL" : "...",
  "itemId" : "...",
  "type" : "ITEM_SUBMITTED",
  "idsAsGroup" : true
}
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
...

GET /2/notifications/get-range-notifications

Request Parameters
name type description default constraints
Authorization header Bearer token, see https://dev.d4science.org/how-to-access-resources    
Content-Type header application/json    
from query 1 min: 1
quantity query 10 min: 0
Response Codes
code condition
200 Notifications retrieved and reported in the 'result' field of the returned object
500 The error is reported into the 'message' field of the returned object
Response Body
media type data type description
application/json object (JSON)

Example

Request
GET /2/notifications/get-range-notifications
Content-Type: */*
Accept: application/json
Authorization: ...

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
...

POST /2/notifications/notify-job-status

Send a JOB notification to a given recipient

Request Parameters
name type description
Authorization header Bearer token, see https://dev.d4science.org/how-to-access-resources
Content-Type header application/json
Request Body
media type data type description
application/json JobNotificationBean (JSON) The job bean
Response Codes
code condition
200 Notification is sent correctly
500 The error is reported into the 'message' field of the returned object
Response Body
media type data type description
application/json object (JSON)

Example

Request
POST /2/notifications/notify-job-status
Content-Type: application/json
Accept: application/json
Authorization: ...

                
{
  "status" : "SUBMITTED",
  "recipient" : "...",
  "job_id" : "...",
  "status_message" : "...",
  "job_name" : "...",
  "service_name" : "..."
}
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
...

POST /2/notifications/workspace

Send a Workspace notification to a given user

Request Parameters
name type description
Authorization header Bearer token, see https://dev.d4science.org/how-to-access-resources
Content-Type header application/json
Request Body
media type data type
application/json WorkspaceEvent (JSON)
Response Codes
code condition
200 Workspace Notification is sent correctly
500 The error is reported into the 'message' field of the returned object
Response Body
media type data type description
application/json object (JSON)

Example

Request
POST /2/notifications/workspace
Content-Type: application/json
Accept: application/json
Authorization: ...

                
{
  "type" : "...",
  "idsAsGroup" : true,
  "idsToNotify" : [ "...", "..." ]
}
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
...