122 lines
2.5 KiB
JSON
122 lines
2.5 KiB
JSON
{
|
|
"title": "Announcement",
|
|
"description": "An announcement or news item.",
|
|
"required": [
|
|
"assocType",
|
|
"title"
|
|
],
|
|
"properties": {
|
|
"_href": {
|
|
"type": "string",
|
|
"description": "The URL to this announcement in the REST API.",
|
|
"format": "uri",
|
|
"readOnly": true,
|
|
"apiSummary": true
|
|
},
|
|
"assocId": {
|
|
"type": "integer",
|
|
"description": "The journal, press or preprint server ID. Null for site-level announcements.",
|
|
"apiSummary": true,
|
|
"validation": [
|
|
"nullable"
|
|
]
|
|
},
|
|
"assocType": {
|
|
"type": "integer",
|
|
"description": "The assoc object. This should always be `ASSOC_TYPE_JOURNAL` (OJS), `ASSOC_TYPE_PRESS` (OMP) or `ASSOC_TYPE_SERVER` (OPS).",
|
|
"apiSummary": true
|
|
},
|
|
"dateExpire": {
|
|
"type": "string",
|
|
"description": "(Optional) The date that this announcement expires, if one is set. This is typically used to express closing dates for calls for papers.",
|
|
"apiSummary": true,
|
|
"validation": [
|
|
"nullable",
|
|
"date_format:Y-m-d"
|
|
]
|
|
},
|
|
"datePosted": {
|
|
"type": "string",
|
|
"description": "The date this announcement was posted.",
|
|
"apiSummary": true,
|
|
"writeDisabledInApi": true,
|
|
"validation": [
|
|
"nullable",
|
|
"date_format:Y-m-d H:i:s"
|
|
]
|
|
},
|
|
"description": {
|
|
"type": "string",
|
|
"description": "The full text of the announcement.",
|
|
"multilingual": true,
|
|
"apiSummary": true,
|
|
"validation": [
|
|
"nullable"
|
|
]
|
|
},
|
|
"descriptionShort": {
|
|
"type": "string",
|
|
"description": "A summary of this announcement.",
|
|
"multilingual": true,
|
|
"apiSummary": true,
|
|
"validation": [
|
|
"nullable"
|
|
]
|
|
},
|
|
"id": {
|
|
"type": "integer",
|
|
"readOnly": true,
|
|
"apiSummary": true
|
|
},
|
|
"image": {
|
|
"type": "object",
|
|
"description": "The image to show with this announcement.",
|
|
"apiSummary": true,
|
|
"validation": [
|
|
"nullable"
|
|
],
|
|
"properties": {
|
|
"temporaryFileId": {
|
|
"type": "integer",
|
|
"writeOnly": true
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"uploadName": {
|
|
"type": "string"
|
|
},
|
|
"dateUploaded": {
|
|
"type": "string"
|
|
},
|
|
"altText": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"title": {
|
|
"type": "string",
|
|
"multilingual": true,
|
|
"apiSummary": true,
|
|
"validation": [
|
|
"nullable"
|
|
]
|
|
},
|
|
"typeId": {
|
|
"type": "integer",
|
|
"description": "(Optional) One of the announcement type ids.",
|
|
"apiSummary": true,
|
|
"validation": [
|
|
"nullable"
|
|
]
|
|
},
|
|
"url": {
|
|
"type": "string",
|
|
"format": "uri",
|
|
"readOnly": true,
|
|
"apiSummary": true,
|
|
"description": "The URL to the published announcement."
|
|
}
|
|
}
|
|
}
|