|
Accessing USOS API server data
|
consumer | Get information on the Consumer. |
installation | Get information on this USOS API installation. |
installations | Get a list of all public USOS API installations. |
now | Get current USOS API time. |
services/apisrv/consumer ¶
|
||||||
https://api.usos.tu.kielce.pl/services/apisrv/consumer | ||||||
Get information on the Consumer. Currently, you can use this method only to get information on a single Consumer - yourself. Simply sign your request with OAuth in order to verify who you are. You may also pass an Access Token along to get some extra information on the permissions granted to you by the user. Important: You are allowed to call this method via the proxy method, but only the token_scopes field will be available (provided that your proxy is signing requests with Access Tokens, if it is not, then you will get null). Make sure you're asking only for the token_scopes field, otherwise you will get an error. | ||||||
fields | required | Pipe-separated list of fields you're interested with. | ||||
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 fields you have asked for. Available fields are:
|
services/apisrv/installation ¶
|
||||||
https://api.usos.tu.kielce.pl/services/apisrv/installation | ||||||
Get some basic information on this USOS API installation. | ||||||
fields | optional |
Default value: base_url|version|machine_version|usos_schema_version|institution_name|contact_emails 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. |
||||
No additional OAuth arguments are required. If you provide any, they will be ignored. | ||||||
Returned value: A dictionary of selected fields and their values. Available fields:
|
services/apisrv/installations ¶
|
||||||
https://api.usos.tu.kielce.pl/services/apisrv/installations | ||||||
Get a list of all public USOS API installation servers (including this one). There are many institutions that use USOS API. Each of them has it's own database and it's own USOS API server. This method allows you to access a list of all public USOS API servers. | ||||||
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. | ||||
No additional OAuth arguments are required. If you provide any, they will be ignored. | ||||||
Returned value: A list of dictionaries, each dictionary in of the same structure that the one returned in the installation method, but the number of fields is limited to the following:
|
services/apisrv/now ¶
|
||||||
https://api.usos.tu.kielce.pl/services/apisrv/now | ||||||
Get the current USOS API time. Your application might call it
periodically in order to determine time offset of our clocks.
Exact timing matters in some cases (like when a registration
starts).
| ||||||
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. | ||||
No additional OAuth arguments are required. If you provide any, they will be ignored. | ||||||
Returned value: A DateTime string (first 19 characters), followed by a dot and a 6-digit fractional part of a second ("yyyy-mm-dd hh:mm:ss.dddddd"). This represents the current USOS API server local time (all DateTime strings API methods return are in local time, unless stated otherwise). |