|
News
|
article | Retrieve a single news article by ID. |
articles | Retrieve multiple articles by their IDs. |
category_index | Retrieve the list of all existing article categories. |
search | Search for articles with simple filters. |
services/news/article ¶
|
||||||
https://usosapps.amu.edu.pl/services/news/article | ||||||
This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can. Retrieve a single news article by ID. | ||||||
article_id | required | ID of the article you want to retrieve information on. | ||||
fields | optional |
Default value: id|author|publication_date|title|headline_html Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section. |
||||
format | optional |
Default value: json Format in which to return values. See supported output formats. |
||||
callback | optional |
Required only if you've chosen jsonp as a return format. |
||||
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus optional oauth_token for Token authorization. | ||||||
Returned value: A dictionary of selected fields and their values. Available fields:
|
services/news/articles ¶
|
||||||
https://usosapps.amu.edu.pl/services/news/articles | ||||||
This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can. Retrieve multiple articles by their IDs. | ||||||
article_ids | required | Pipe-separated list of article IDs to be retrieved. | ||||
fields | optional |
Default value: id|author|publication_date|title|headline_html Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of article method. |
||||
format | optional |
Default value: json Format in which to return values. See supported output formats. |
||||
callback | optional |
Required only if you've chosen jsonp as a return format. |
||||
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus optional oauth_token for Token authorization. | ||||||
Returned value: A dictionary that will map your article_ids to article objects, as defined in the aricle method. If the article cannot be found, or you don't have access to it, then the ID you have supplied will still be present in this response, but the value mapped to it will be null (instead of an object). |
services/news/category_index ¶
|
||||||
https://usosapps.amu.edu.pl/services/news/category_index | ||||||
This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can. Retrieve the list of all existing article categories. This list includes the default category, which contains all news that weren't assigned to any other specific category. | ||||||
fields | optional |
Default value: id|name Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section. |
||||
format | optional |
Default value: json Format in which to return values. See supported output formats. |
||||
callback | optional |
Required only if you've chosen jsonp as a return format. |
||||
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus optional oauth_token for Token authorization. | ||||||
Returned value: A dictionary of selected fields and their values. Available fields:
|
services/news/search ¶
|
||||||
https://usosapps.amu.edu.pl/services/news/search | ||||||
This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can. Search for articles with simple filters. | ||||||
from_date | optional |
Default value: (empty string) Datetime string. If given, then only those articles which have publication date greater or equal to this date, will be returned. |
||||
facpattern | optional |
Default value: (empty string) Optional filter of faculties in the "facpattern" format, as described in the services/fac/resolve_facpattern method. If given, then only such news which belong to the faculties matching this pattern will be returned. |
||||
category_ids | optional |
Default value: (empty string) The list of article category IDs. If given, then only such articles which are in one of the specified categories, will be returned. Existing categories may be retrieved via the category_index method. |
||||
num | optional |
Default value: 6 The number of articles to return. The maximum allowed value is 100. |
||||
start | optional |
Default value: 0 The index of the first matching article that is to be included in the response (zero-based). |
||||
fields | optional |
Default value: items[article[id]]|next_page|total Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section. |
||||
format | optional |
Default value: json Format in which to return values. See supported output formats. |
||||
callback | optional |
Required only if you've chosen jsonp as a return format. |
||||
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus optional oauth_token for Token authorization. | ||||||
Returned value: A dictionary of the following structure:
|