...
Code Block | ||||
---|---|---|---|---|
| ||||
{ "activity" : { "priority": 0.0, "icon": "icon-comment-alt", "actor": { "id" : "department identifier", "objectType": "person", "displayName": "Department Name", "author" : { "id" : "kName", "displayName" : "FirstName LastName" } }, "verb": "post", "title": "Test Notification", "object": { "ucdSrcId" : "content identifier", "objectType": "notification", "content": "This is a test notification", "ucdEdusModel" : { "url" : "http://ucdavis.edu", "urlDisplayName" : "UC Davis" } }, "to" : { "groups" : ["students", "faculty"], "users" : [] }, "ucdEdusMeta" : { "labels" : ["academic"], "authzId" : "<Same as actor.author.id>", "startDate" : "date string", "endDate" : "date string" } }} |
Activity fields:
Key | Type | Comment | Required (R) |
---|---|---|---|
priority | Number | Use 0.0 | R |
icon | String | Any available Twitter Bootstrap icon name | R |
actor | Object |
| R |
actor.id | String | Unique Actor ID (This will be provided by the Aggie Feed Team) | R |
actor.objectType | String | One of ["person", "department"] | R |
actor.displayName | String | Department Name | R |
actor.author | Object |
| R |
actor.author.id | String | Unique Author ID (kName) | R |
actor.author.displayName | String | Author Name (FirstName LastName) | R |
verb | String | Use "update" | R |
title | String | Activity Title | R |
object | Object |
| R |
object.id | String | Unique Content ID | R |
object.objectType | String | Use "notification" | R |
object.content | String | Activity content (Text) | R |
to | Object | NOTE: The "to" field has to have one or both of the following properties: [ groups, users ] | R |
to.groups | Array | Array of group names: "public", "students", "faculty", "staff" | R / O |
to.users | Array | Array of user kNames | R / O |
published | String | ISO-8601 Date format YYYY-MM-DDTHH:mm:ss.SSSZ | O |
ucdEdusMeta | Object |
| R |
ucdEdusMeta.labels | Array | Array of strings. The array needs to contain at least one of the following labels: ["academic", "campus-life"] | R |
ucdEdusMeta.startDate | String | ISO-8601 Date format YYYY-MM-DDTHH:mm:ss.SSSZ | O |
ucdEdusMeta.endDate | String | ISO-8601 Date format YYYY-MM-DDTHH:mm:ss.SSSZ | O |
ucdEdusMeta.authzId | String | Same as actor.author.id | R |
ucdEdusModel | Object |
| R |
ucdEdusModel.url | String | Activity content related URL | O |
ucdEdusModel.urlDisplayName | String | Activity content related URL display name | O |
ucdEdusModel.eventDate | String | Date the event will occur. | O |
Sample request body containing the activity (JSON):
...
{
"activity" :
{
"priority": 0.0,
"icon": "icon-comment-alt",
"actor": {
"id" : "department identifier",
"objectType": "person",
"displayName": "Department Name",
"author" : {
"id" : "kName",
"displayName" : "FirstName LastName"
}
},
"verb": "update",
"title": "Test Notification",
"object": {
"id" : "content identifier",
"objectType": "notification",
"content": "This is a test notification"
},
"to" : {
"groups" : ["students", "faculty"],
"users" : []
},
"ucdEdusMeta" : {
"labels" : ["academic"],
"authzId" : "<Same as actor.author.id>",
"startDate" : "date string",
"endDate" : "date string"
},
"ucdEdusModel" : {
"url" : "",
"urlDisplayName" : ""
}
}
}