|
Placement tests
|
test | Get information on given placement test |
test_result | Get placement test's result |
tests_index | Get IDs of all placement tests |
update_result | Update test result (administrative) |
update_results | Update test result (administrative) |
user | User's results |
services/plctests/test ¶
|
||||||
https://api.usos.tu.kielce.pl/services/plctests/test | ||||||
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. Get information on given placement test | ||||||
id | required | ID of placement test | ||||
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. |
||||
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:
| ||||||
Thrown errors:
|
services/plctests/test_result ¶
|
||||||
https://api.usos.tu.kielce.pl/services/plctests/test_result | ||||||
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.
Get result of token issuer's placement test
| ||||||
test_id | required | ID of placement test | ||||
fields | optional |
Default value: user_id|test|value 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 required oauth_token for Token authorization. | ||||||
Returned value: A dictionary of selected fields and their values. Available fields:
| ||||||
Thrown errors:
|
services/plctests/tests_index ¶
|
||||||
https://api.usos.tu.kielce.pl/services/plctests/tests_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. Get IDs of all placement tests | ||||||
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: List with IDs |
services/plctests/update_result ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://api.usos.tu.kielce.pl/services/plctests/update_result | ||||||
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. Update result of placement test for given user to 'new_value'. If you want to avoid concurrency problems (if two or more users are modifying same results), you may specify "old_value" parameter. Result will be updated only if given value match with currently value in database. | ||||||
test_id | required | ID of placement test | ||||
user_id | required | ID of user whose grade will be updated | ||||
new_value | required | Number of points, that you want to set | ||||
old_value | optional |
Default value: (If parameter is unused, no check will be made) Number of points, that you expect that is current set. If you expect that result wasn't entered yet, set this parameter to null. |
||||
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. Token is not required. | ||||||
Returned value: An empty dictionary returned if the method has been executed successfully. Some keys may be added in the future. | ||||||
Thrown errors:
|
services/plctests/update_results ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://api.usos.tu.kielce.pl/services/plctests/update_results | ||||||
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. Update result of placement test for given users | ||||||
test_id | required | ID of placement test | ||||
new_values | required | Dictionary mapping user IDs to numbers of points, that you want to set | ||||
old_values | required | Dictionary mapping user IDs to numbers of points, you expect that is currently set (similarly to parameter old_value in method update_result). Note that if you use this parameter dictionary must contain the same user IDs as dictionary passed in new_values parameter. | ||||
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. Token is not required. | ||||||
Returned value: An empty dictionary returned if the method has been executed successfully. Some keys may be added in the future. | ||||||
Thrown errors:
|
services/plctests/user ¶
|
||||||
https://api.usos.tu.kielce.pl/services/plctests/user | ||||||
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. User's results | ||||||
fields | optional |
Default value: user_id|test|value Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of test_result 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 required oauth_token for Token authorization. | ||||||
Returned value: Dictionary mapping placement test ID to dictionaries returned by test_result method. |