|
Course tests
|
all_user_points | Get points of a student. (administrative) |
change_folder_node_permissions | Change FolderNode permissions. |
change_folder_node_properties | Change properties of a FolderNode. |
change_grade_node_permissions | Change GradeNode permissions. |
change_grade_node_properties | Change properties of a GradeNode. |
change_root_node_permissions | Change RootNode permissions. |
change_root_node_properties | Change properties of a RootNode. |
change_task_node_permissions | Change TaskNode permissions. |
change_task_node_properties | Change properties of a TaskNode. |
connect_template_to_course_edition | Connect a template to a course edition. (administrative) |
course_test | Get informations about course test |
create_folder_node | Create a FolderNode (administrative) |
create_grade_node | Creates a GradeNode (administrative) |
create_root_node | Create a RootNode (administrative) |
create_task_node | Create a TaskNode. (administrative) |
delete_subtree | Delete a subtree of test. (administrative) |
duplicate_subtree | Duplicate a subtree. (administrative) |
duplicate_tree | Duplicate a test or a template. (administrative) |
examinee | common tests |
folder_node | Get a FolderNode. |
folder_node_details | Get folder node details |
grade_node | Get a GradeNode. |
grade_node_details | Details of a grade node |
groups | Get groups of a test. |
lecturer | Get lecturer's tests. |
lecturer2 | Get student's tests |
move_node | Move a node. (administrative) |
node | (deprecated) Get nodes |
node2 | Get nodes |
node_grades | Get grades given in some node. (administrative) |
node_points | Get points given in some node. (administrative) |
node_stats | Node statistics |
participant | Get student's tests. |
participant2 | Get student's tests |
public_templates | Get public templates templates. |
root_node | Get description of a RootNode. |
root_nodes | Get multiple RootNodes. |
student_grade | Get student's grade for a single node. |
student_point | Get points which token issuer got in node specified by node_id parameter |
subscribe | Grant ReadPerm. |
task_node | Get a TaskNode. |
task_node_details | Details of a task node |
unsubscribe | Remove ReadPerm. |
update_grades | Give grades to students. |
update_points | Give points to students. |
user_grade | Get student's grade for a single node. |
user_grade_modified | Notify about user's course test grade modification. (administrative) |
user_grades | Get student's grades for some nodes. |
user_grades_modified | Notify USOS API that crstests grades were modified. (administrative) |
user_point | Get points of a student for a single node. |
user_point_modified | Notify about user's course test points modification. (administrative) |
user_points | Get points of a student. |
user_points_modified | Notify USOS API that crstests points were modified. (administrative) |
services/crstests/all_user_points ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/all_user_points | ||||||
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 all points which a token issuer got in nodes specified by node_ids parameter.
Note that method returns points even that are invisible for students.
This method should be used when all points are needed (e.g. for automatic
grading (algorithm note).
| ||||||
node_ids | required | Pipe-separated list of node ids. All the node_ids supplied should belong to one test tree. | ||||
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: List of TestPointsObject. |
services/crstests/change_folder_node_permissions ¶
|
||||||
https://usosapps.umk.pl/services/crstests/change_folder_node_permissions | ||||||
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.
Changes permissions in a FolderNode.
For each pair (user_id, perms) present in the set parameter this method will set permissions of user with ID = user_id to perms. For each pair (user_id, perms) present in th remove_from_subtree parameter this method will remove all permissions in the perms list for user with ID = user_id in the subtree of referenced node. | ||||||
node_id | required | node ID | ||||
set | required | Dictionary mapping from user ID to lists of PermissionsObjects | ||||
remove_from_subtree | optional | Dictionary mapping from user ID to lists of PermissionsObjects | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/change_folder_node_properties ¶
|
||||||
https://usosapps.umk.pl/services/crstests/change_folder_node_properties | ||||||
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.
Changes properties of a FolderNode.
Please note: only properties present in the parameters of this method will be changed (other properties will remain unchanged). | ||||||
node_id | required | node ID | ||||
name_pl | optional | Name of the node (in polish). | ||||
name_en | optional | Name of the node (in english). | ||||
visible_for_students | optional | boolean, if true the results from this node will be visible to students | ||||
description_pl | optional | Description of the node (in polish) | ||||
description_en | optional | Description of the node (in english) | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/change_grade_node_permissions ¶
|
||||||
https://usosapps.umk.pl/services/crstests/change_grade_node_permissions | ||||||
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.
Changes permissions in a GradeNode.
For each pair (user_id, perms) present in the set parameter this method will set permissions of user with ID = user_id to perms. For each pair (user_id, perms) present in th remove_from_subtree parameter this method will remove all permissions in the perms list for user with ID = user_id in the subtree of referenced node. | ||||||
node_id | required | node ID | ||||
set | required | Dictionary mapping from user ID to lists of PermissionsObjects | ||||
remove_from_subtree | optional | Dictionary mapping from user ID to lists of PermissionsObjects | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/change_grade_node_properties ¶
|
||||||
https://usosapps.umk.pl/services/crstests/change_grade_node_properties | ||||||
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.
Changes properties of a GradeNode.
Please note: only properties present in the parameters of this method will be changed (other properties will remain unchanged). | ||||||
node_id | required | node ID | ||||
name_pl | optional | Name of the node (in polish). | ||||
name_en | optional | Name of the node (in english). | ||||
visible_for_students | optional | boolean, if true the results from this node will be visible to students | ||||
algorithm | optional | source code of the algorithm used for automatic grading, (see algorithm note) | ||||
variables | optional | variables of the algorithm used for automatic grading (see algorithm note) | ||||
algorithm_description_pl | optional | description of the algorithm (in polish) used for automatic grading | ||||
algorithm_description_en | optional | description of the algorithm (in polish) used for automatic grading | ||||
dependencies | optional | dependencies of the algorithm used for automatic grading JSON encoded dictionary mapping node IDs to handles. (see algorithm note) | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/change_root_node_permissions ¶
|
||||||
https://usosapps.umk.pl/services/crstests/change_root_node_permissions | ||||||
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.
Changes permissions in a RootNode.
For each pair (user_id, perms) present in the set parameter this method will set permissions of user with ID = user_id to perms. For each pair (user_id, perms) present in th remove_from_subtree parameter this method will remove all permissions in the perms list for user with ID = user_id in the subtree of referenced node. | ||||||
node_id | required | node ID | ||||
set | required | Dictionary mapping from user ID to lists of PermissionsObjects | ||||
remove_from_subtree | optional | Dictionary mapping from user ID to lists of PermissionsObjects | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/change_root_node_properties ¶
|
||||||
https://usosapps.umk.pl/services/crstests/change_root_node_properties | ||||||
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.
Changes properties of a RootNode.
Please note: only properties present in the parameters of this method will be changed (other properties will remain unchanged). | ||||||
node_id | required | node ID | ||||
name_pl | optional | Name of the node (in polish). | ||||
name_en | optional | Name of the node (in english). | ||||
visible_for_students | optional | boolean, if true the results from this node will be visible to students | ||||
description_pl | optional | Description of the node (in polish) | ||||
description_en | optional | Description of the node (in english) | ||||
public | optional | boolean, should the template be visible to others, only permitted for roots of templates | ||||
limit_to_groups | optional | string - 'false' if the root should not be limited to groups or List of strings. Each of the following format (without quotes): "(unit_id|group_number)" representing the groups this test should be limited to. | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/change_task_node_permissions ¶
|
||||||
https://usosapps.umk.pl/services/crstests/change_task_node_permissions | ||||||
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.
Changes permissions in a TaskNode.
For each pair (user_id, perms) present in the set parameter this method will set permissions of user with ID = user_id to perms. For each pair (user_id, perms) present in th remove_from_subtree parameter this method will remove all permissions in the perms list for user with ID = user_id in the subtree of referenced node. | ||||||
node_id | required | node ID | ||||
set | required | Dictionary mapping from user ID to lists of PermissionsObjects | ||||
remove_from_subtree | optional | Dictionary mapping from user ID to lists of PermissionsObjects | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/change_task_node_properties ¶
|
||||||
https://usosapps.umk.pl/services/crstests/change_task_node_properties | ||||||
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.
Changes properties of a TaskNode.
Please note: only properties present in the parameters of this method will be changed (other properties will remain unchanged). | ||||||
node_id | required | node ID | ||||
name_pl | optional | Name of the node (in polish). | ||||
name_en | optional | Name of the node (in english). | ||||
visible_for_students | optional | boolean, if true the results from this node will be visible to students | ||||
algorithm | optional | source code of the algorithm used for automatic grading, (see algorithm note) | ||||
variables | optional | variables of the algorithm used for automatic grading (see algorithm note) | ||||
algorithm_description_pl | optional | description of the algorithm (in polish) used for automatic grading | ||||
algorithm_description_en | optional | description of the algorithm (in polish) used for automatic grading | ||||
dependencies | optional | dependencies of the algorithm used for automatic grading JSON encoded dictionary mapping node IDs to handles. (see algorithm note) | ||||
points_precision | optional | integer in range [0, 3], the number of digits after the decimal dot | ||||
points_min | optional | minimal number of points for a task, should be less or equal to 0, only permitted for task node | ||||
points_max | optional | maximal number of points for a task, should be greater than 0, only permitted for task node | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/connect_template_to_course_edition ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/connect_template_to_course_edition | ||||||
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.
Connects a template to a course edition.
| ||||||
root_id | required | ID of the root of a template. | ||||
course_id | required | Course ID of a course edition. | ||||
term_id | required | Term ID of a course edition. | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/course_test ¶
|
||||||
https://usosapps.umk.pl/services/crstests/course_test | ||||||
Get informations about course test | ||||||
id | required | ID of a course test | ||||
fields | optional |
Default value: course_edition|is_limited_to_groups|class_groups|root 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 optional 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/crstests/create_folder_node ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/create_folder_node | ||||||
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.
Creates a FolderNode with the specified parameters.
If you won't provide name_pl parameter, the default value = "Pusty Folder" will be used. | ||||||
parent_id | required | ID of the parent node for our new node. The type of this node must be root or folder. | ||||
name_pl | optional | Name of the node (in polish). | ||||
name_en | optional | Name of the node (in english). | ||||
order | optional | integer - order (see ordering) | ||||
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 with only one key 'id'. ID of the newly created FolderNode. |
services/crstests/create_grade_node ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/create_grade_node | ||||||
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.
Creates a GradeNode with the specified parameters.
If you won't provide name_pl parameter, the default value = "Nowa Ocena" will be used. | ||||||
parent_id | required | ID of the parent node for our new node. The type of this node must be root or folder. | ||||
grade_type | required | ID of the grade type. Same as 'grade_type_id' parameter of the grade_type method. | ||||
name_pl | optional | Name of the node (in polish). | ||||
name_en | optional | Name of the node (in english). | ||||
order | optional | integer - order (see ordering) | ||||
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 with only one key 'id'. ID of the newly created GradeNode. |
services/crstests/create_root_node ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/create_root_node | ||||||
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.
Create a RootNode with specified parameters.
If you won't provide name_pl parameter, the default value = "Pusty Szablon" will be used. | ||||||
name_pl | optional | Name of the node (in polish). | ||||
name_en | optional | Name of the node (in english). | ||||
description_pl | optional | Description (in polish) | ||||
description_en | optional | Description (in english) | ||||
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 with only one key 'id'. ID of the newly created RootNode (it will be a template). |
services/crstests/create_task_node ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/create_task_node | ||||||
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.
Creates a TaskNode with the specified parameters.
If you won't provide name_pl parameter, the default value = "Nowe Zadanie" will be used. If you won't provide some other parameters, their respective default values will be used. | ||||||
parent_id | required | ID of the parent node for our new node. The type of this node must be root or folder. | ||||
name_pl | optional | Name of the node (in polish). | ||||
name_en | optional | Name of the node (in english). | ||||
order | optional | integer - order (see ordering) | ||||
points_min | optional | Minimal number of points available for this task. Default value = 0.0 | ||||
points_max | optional | Maximal number of points available for this task. Default value = 10.0 | ||||
points_precision | optional | The number of digits after the decimal point. It should be used while displaying points from this node. Default value = 1 | ||||
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 with only one key 'id'. ID of the newly created TaskNode. |
services/crstests/delete_subtree ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/delete_subtree | ||||||
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.
This methods deletes a subtree rooted in some supplied node.
All the data of the nodes in the deleted subtree will be also erased.
| ||||||
node_id | required | ID of the root of the subtree to delete. | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/duplicate_subtree ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/duplicate_subtree | ||||||
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.
Duplicates a subtree of the test.
The duplicated subtree has the same parent as the base subtree. The order of the root of the new subtree
is highest possible i.e. it is added as the last child to the parent.
Please note:
| ||||||
node_id | required | ID of the node which is the root of the subtree we want to duplicate. | ||||
name_pl | required | Name of the root of the duplicated subtree (in polish). | ||||
name_en | optional | Name of the root of the duplicated subtree (in english). | ||||
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 with only one key 'id'. ID of the newly created root of the duplicated subtree (not the root of the whole tree). |
services/crstests/duplicate_tree ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/duplicate_tree | ||||||
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.
Duplicates a test or a template.
Only structure and properties are duplicated.
Grades, points, permissions are not duplicated.
The newly created tree is a template.
| ||||||
root_id | required | ID of the root of the tree to duplicate. | ||||
name_pl | required | Name of the new test (in polish). | ||||
name_en | optional | Name of the new test (in english). | ||||
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 with only one key 'id'. ID of the newly created template. |
services/crstests/examinee ¶
|
||||||
https://usosapps.umk.pl/services/crstests/examinee | ||||||
common tests | ||||||
student_id | required | ID of student whoose tests will be returned | ||||
fields | optional |
Default value: course_edition|is_limited_to_groups|class_groups|root Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of course_test 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: Returns list of course tests where access token issuer has access to given student points |
services/crstests/folder_node ¶
|
||||||
https://usosapps.umk.pl/services/crstests/folder_node | ||||||
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 detailed information about some FolderNode.
| ||||||
node_id | required | node ID | ||||
fields | required | Pipe-separated list of informational fields/sections you're interested in. This must be any subset of keys, 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 result fields and their values. Available fields:
|
services/crstests/folder_node_details ¶
|
||||||
https://usosapps.umk.pl/services/crstests/folder_node_details | ||||||
Get folder node details | ||||||
id | required | ID of a node | ||||
fields | required |
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 optional 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/crstests/grade_node ¶
|
||||||
https://usosapps.umk.pl/services/crstests/grade_node | ||||||
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 detailed information about some GradeNode.
| ||||||
node_id | required | node ID | ||||
fields | required | Pipe-separated list of informational fields/sections you're interested in. This must be any subset of keys, 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 result fields and their values. Available fields:
|
services/crstests/grade_node_details ¶
|
||||||
https://usosapps.umk.pl/services/crstests/grade_node_details | ||||||
Details of a grade node | ||||||
id | required | ID of a node | ||||
fields | required |
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 optional 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/crstests/groups ¶
|
||||||
https://usosapps.umk.pl/services/crstests/groups | ||||||
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.
If a root of a test has limit_to_groups parameter set
then this method will return the groups the test is limited to, otherwise
it will return all the groups of the course edition the test is connected to.
The root_id you supply must be an ID of a test which is connected to some course edition.
| ||||||
root_id | required | ID of a root of a test (this test must be a template). | ||||
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: List of the dictionaries of the following structure:
|
services/crstests/lecturer ¶
|
||||||
https://usosapps.umk.pl/services/crstests/lecturer | ||||||
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.
This methods returns tests for which the lecturer has at least read access permission.
| ||||||
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 result fields and their values. Available fields:
|
services/crstests/lecturer2 ¶
|
||||||
https://usosapps.umk.pl/services/crstests/lecturer2 | ||||||
Get student's tests | ||||||
fields | optional |
Default value: course_edition|is_limited_to_groups|class_groups|root Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of course_test method. |
||||
active_terms_only | optional |
Default value: true Return only tests from active academic terms |
||||
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: List of tests that student is assigned to |
services/crstests/move_node ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/move_node | ||||||
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.
You can use this method to move whole subtree.
| ||||||
node_id | required | ID of the node to move. | ||||
new_parent_id | required | ID of the new parent of the moved node. Please note: the new parent can't belong to subtree You try to move | ||||
new_order | required | New order of the moved node. | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/node ¶
|
||||||
https://usosapps.umk.pl/services/crstests/node | ||||||
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. This method is deprecated, please avoid using it - read more Suggested replacement: services/crstests/node2 This method can be used to fetch whole subtree of a test, or only a node with its direct subnodes, see return section for more information. | ||||||
node_id | required |
ID of the subtree root.
Please note that this node doesn't have to be a RootNode. |
||||
recursive | required | boolean - if true the whole subtree will be returned, otherwise only direct subnodes will be returned | ||||
fields | required | Pipe-separated list of informational fields/sections you're interested in. This must be any subset of keys, 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: Let's name a node with ID = node_id a current node. A dictionary describing the current node will be returned. This dictionary will be equal to the dictionary You would get by calling one of the methods: root_node, task_node, grade_node, folder_node with the fields parameter limited to those fields that are defined for each specific method. Except that this dictionary may contain one additional field subnodes (only if 'subnodes' is in fields) - a list of dictionaries, each representing a subnode of the current node. If recursive is set to true than those dictionaries also contain a subnodes field. You can get the details of a whole subtree that way. Moreover the dictionaries in the subnodes field will be sorted by the order key (see ordering); |
services/crstests/node2 ¶
|
||||||
https://usosapps.umk.pl/services/crstests/node2 | ||||||
This method can be used to fetch whole subtree of a test, or only a node with its direct subnodes,
see return section for more information.
| ||||||
node_id | required | ID of the subtree root | ||||
fields | optional |
Default value: id|order|name|description|visible_for_students|type|subnodes 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 optional 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/crstests/node_grades ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/node_grades | ||||||
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 all the grades given in some node.
Please see the note about automatic grading (algorithm note).
Notice: Please do not provide a user token here for this method. | ||||||
node_id | required | ID of a node. | ||||
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: List of TestGradeObjects. |
services/crstests/node_points ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/node_points | ||||||
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 all the points given in some node.
Please see the note about automatic grading (algorithm note).
Notice: Please do not provide a user token here for this method. | ||||||
node_id | required | Pipe-separated list of node ids | ||||
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: List of TestPointsObjects. |
services/crstests/node_stats ¶
|
||||||
https://usosapps.umk.pl/services/crstests/node_stats | ||||||
Node statistics | ||||||
node_id | required | ID of a node | ||||
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 following fields and their values:
|
services/crstests/participant ¶
|
||||||
https://usosapps.umk.pl/services/crstests/participant | ||||||
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.
This method retrieves all the tests that concern a student.
| ||||||
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 result fields and their values. Available fields:
|
services/crstests/participant2 ¶
|
||||||
https://usosapps.umk.pl/services/crstests/participant2 | ||||||
Get student's tests | ||||||
fields | optional |
Default value: course_edition|is_limited_to_groups|class_groups|root Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of course_test method. |
||||
active_terms_only | optional |
Default value: true Return only tests from active academic terms |
||||
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: List of tests that student is assigned to |
services/crstests/public_templates ¶
|
||||||
https://usosapps.umk.pl/services/crstests/public_templates | ||||||
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 list of public templates.
| ||||||
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: List of all public templates (represented as dictionaries). Each dictionary will contain primary fields from root_node method. |
services/crstests/root_node ¶
|
||||||
https://usosapps.umk.pl/services/crstests/root_node | ||||||
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 detailed information about some RootNode.
| ||||||
node_id | required | node ID | ||||
fields | required | Pipe-separated list of informational fields/sections you're interested in. This must be any subset of keys, 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 result fields and their values. Available fields:
|
services/crstests/root_nodes ¶
|
||||||
https://usosapps.umk.pl/services/crstests/root_nodes | ||||||
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 detailed information on multiple RootNodes.
| ||||||
node_ids | required | Pipe-separated list of root node IDs. | ||||
fields | required | Pipe-separated list of fields, same as in root_node. | ||||
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: your root_ids will be mapped to dictionary's keys, and each value will contain the description of a root node, as defined in the root_node |
services/crstests/student_grade ¶
|
||||||
https://usosapps.umk.pl/services/crstests/student_grade | ||||||
Get grade which a token issuer got in node specified by node_id parameter.
| ||||||
node_id | required | ID of the node. | ||||
fields | optional |
Default value: grade_value|automatic_grade_value|comment|last_changed 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/crstests/student_point ¶
|
||||||
https://usosapps.umk.pl/services/crstests/student_point | ||||||
Get points which token issuer got in node specified by node_id parameter | ||||||
node_id | required | The node id. | ||||
fields | optional |
Default value: points|comment|grader|last_changed 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/crstests/subscribe ¶
|
||||||
https://usosapps.umk.pl/services/crstests/subscribe | ||||||
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.
This method grants ReadPerm to a specified public template to an
issuer.
Please not that no permissions are required by this method.
| ||||||
node_id | required | node ID | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/task_node ¶
|
||||||
https://usosapps.umk.pl/services/crstests/task_node | ||||||
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 detailed information about some TaskNode.
| ||||||
node_id | required | node ID | ||||
fields | required | Pipe-separated list of informational fields/sections you're interested in. This must be any subset of keys, 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 result fields and their values. Available fields:
|
services/crstests/task_node_details ¶
|
||||||
https://usosapps.umk.pl/services/crstests/task_node_details | ||||||
Details of a task node | ||||||
id | required | ID of a node | ||||
fields | optional |
Default value: points_min|points_max|points_precision|dependencies|variables|algorithm|algorithm_description 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 optional 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/crstests/unsubscribe ¶
|
||||||
https://usosapps.umk.pl/services/crstests/unsubscribe | ||||||
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.
This method removes ReadPerm permission in a public template for an issuer.
Please note that no permissions are required by this method.
| ||||||
node_id | required | node ID | ||||
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: Currently, this method always returns the same value: a dictionary with single success key with value of true. |
services/crstests/update_grades ¶
|
||||||
https://usosapps.umk.pl/services/crstests/update_grades | ||||||
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.
This method enables a lecturer to give and change already given grades in a particular node.
Please see the note about automatic grading (algorithm note).
| ||||||
node_id | required | ID of the grade node. | ||||
new_grades | required |
Dictionary mapping from student ids to dictionaries of the following structure
(these fields, except 'order' field match the fields of the TestGradeObject object):
|
||||
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: If the method succeeds a dictionary with single key 'success' and value true will be returned. In case of the failure i.e. You are trying to modify grades that were modified in the meantime ('last_changed' parameters didn't match) we will respond with HTTP 400. |
services/crstests/update_points ¶
|
||||||
https://usosapps.umk.pl/services/crstests/update_points | ||||||
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.
This method enables a lecturer to give and change already given points in a particular node.
Please see the note about automatic grading (algorithm note).
| ||||||
new_points | required |
Dictionary mapping from student ids to dictionaries of the following structure
(these fields match the fields of the TestPointsObject object):
|
||||
node_id | required | ID of the task node. | ||||
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: If the method succeeds a dictionary with single key 'success' and value true will be returned. In case of the failure i.e. You are trying to modify grades that were modified in the meantime ('last_changed' parameters didn't match) we will respond with HTTP 400. |
services/crstests/user_grade ¶
|
||||||
https://usosapps.umk.pl/services/crstests/user_grade | ||||||
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 grade which a token issuer got in node specified by node_id parameter. Please see the note about automatic grading (algorithm note). | ||||||
node_id | required | The node id. | ||||
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 single TestGradeObject or an empty dictionary if a token issuer does not have grade in node. |
services/crstests/user_grade_modified ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/user_grade_modified | ||||||
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. Notify USOS API about user's course test grade modification. USOS API notifications system will pass this information to those subscribed to crstests/user_grade event. This method does not check if the provided parameter value refers to a valid node. You do not need to call this method if it was you who modified the node grade or visibility through appropriate methods. | ||||||
operation | required | Operation that has been applied to user course test grade. | ||||
node_id | required | The node id. | ||||
related_user_ids | required | A list with one element: the ID of a user whose course points have been modified. | ||||
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: Empty dictionary. |
services/crstests/user_grades ¶
|
||||||
https://usosapps.umk.pl/services/crstests/user_grades | ||||||
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 grades which a token issuer got in nodes specified by node_ids parameter. Please see the note about automatic grading (algorithm note). | ||||||
node_ids | required | Pipe-separated list of node ids. All the node_ids supplied should belong to one test tree. | ||||
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: List of TestGradeObject. |
services/crstests/user_grades_modified ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/user_grades_modified | ||||||
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. Notify USOS API about modifications of multiple user's course test grades. The result of this method is equal to calling user_grade_modified method multiple times. Note that you need administrative scope for user_grade_modified method in order to perform a successful call to this method. | ||||||
user_grade_modified_params | required | A list of dictionaries containing fields and values that match the parameters of user_grade_modified 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. Token is not required. | ||||||
Returned value: Empty dictionary. |
services/crstests/user_point ¶
|
||||||
https://usosapps.umk.pl/services/crstests/user_point | ||||||
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 points which a token issuer got in node specified by node_id parameter. Please see the note about automatic grading (algorithm note). | ||||||
node_id | required | The node id. | ||||
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 single TestPointsObject or an empty dictionary if a token issuer does not have points in node. |
services/crstests/user_point_modified ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/user_point_modified | ||||||
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. Notify USOS API about user's course test points modification. USOS API notifications system will pass this information to those subscribed to crstests/user_point event. This method does not check if the provided parameter value refers to a valid node. You do not need to call this method if it was you who modified the node points or visibility through appropriate methods. | ||||||
operation | required | Operation that has been applied to user course points. | ||||
node_id | required | The node id. | ||||
related_user_ids | required | A list with one element: the ID of a user whose course points have been modified. | ||||
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: Empty dictionary. |
services/crstests/user_points ¶
|
||||||
https://usosapps.umk.pl/services/crstests/user_points | ||||||
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 points which a token issuer got in nodes specified by node_ids parameter.
Please see the note about automatic grading (algorithm note).
| ||||||
node_ids | required | Pipe-separated list of node ids. All the node_ids supplied should belong to one test tree. | ||||
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: List of TestPointsObject. |
services/crstests/user_points_modified ¶
Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.
|
||||||
https://usosapps.umk.pl/services/crstests/user_points_modified | ||||||
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. Notify USOS API about modifications of multiple user's course test points. The result of this method is equal to calling user_point_modified method multiple times. Note that you need administrative scope for user_point_modified method in order to perform a successful call to this method. | ||||||
user_point_modified_params | required | A list of dictionaries containing fields and values that match the parameters of user_point_modified 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. Token is not required. | ||||||
Returned value: Empty dictionary. |