Extension:PeerEvaluation/API

definitions

 * a user is a logged in WikiEducator user, presumed to be participating in one or more courses as a learner
 * a facilitator is a logged in WikiEducator user that is part of the facilitator group of users, presumed to be teaching a course (or to have taught any course in the past)
 * a course may include one or more activities
 * a facilitator is expected to provide a rubric for each activity
 * a user makes a submission for a particular activity, optionally opting-in for peer evaluation
 * a user can submit a formative evaluation on a submission (including their own)

uses
(optional parameter to narrow result set)
 * user submits work for peer evaluation (new submission replaces old)
 * user submits evaluation of an item (new or revised)
 * user requests all evaluations of their work for a course (for an activity)
 * user requests all evaluations they have done for a course (for an activity)
 * facilitator requests all evaluation items for a course (for an activity) (for a learner)
 * request all courses (matching substring)
 * request all activities for a course

examples

 * get all unique courses
 * api.php?action=evaluations&evprop=courses


 * get all unique activities for a course
 * api.php?action=evaluations&evprop=activities&evcourse=OCL4Ed+14.06


 * get all (my) submissions for a course
 * api.php?action=evaluations&evprop=submissions&evcourse=OCL4Ed+14.06


 * get my submission for a particular activity
 * api.php?action=evaluations&evprop=submissions&evcourse=OCL4Ed+14.06&evactivity=e-Learning+Activity+4.1

Parameters
only accepts POST requests

pecourse and peactivity are wiki page URL's of their respective pages relative to the main page. Example: For OCL4Ed ( http://wikieducator.org/course/OCL4Ed/ ) pecourse="course/OCL4Ed"

Parameters
only accepts POST requests