{"id":1373,"date":"2012-11-27T13:53:12","date_gmt":"2012-11-27T13:53:12","guid":{"rendered":"https:\/\/blog.lboro.ac.uk\/lorls\/?page_id=1373"},"modified":"2012-11-27T13:53:12","modified_gmt":"2012-11-27T13:53:12","slug":"getsurating","status":"publish","type":"page","link":"https:\/\/blog.lboro.ac.uk\/lorls\/documentation\/integration\/lumps-apis\/getsurating","title":{"rendered":"GetSURating"},"content":{"rendered":"<pre>NAME\n    GetSURating - Return the number of good\/bad ratings from users.\n\nDESCRIPTION\n    The GetSURating CGI script allows rating from end users for one or more\n    Structural Units to be returned in XML format.\n\nPARAMETERS\n  Standard\n    *username* - Name of user running this CGI script. Required unless web\n    server authentication is in use (when it is, the web server\n    authenticated user is used instead).\n    *password* - Password for the user. This is only required if the web\n    server is not handling the user authentication and if no security hash\n    parameter is being given.\n    *security_hash* - An opaque value used to authenticate the user without\n    requiring the password to be sent. This value is generated by a previous\n    execution of a LUMP API script and may well be time limited. It is only\n    required if no password or webserver authentication is done.\n    *act_as* - Users in the SysAdmins group can elect to act on the behalf\n    of other users once they are themselves authenticated. If this parameter\n    is present it should contain the username of the user that should be\n    switched to if this option is available and the real user has been\n    authenticated successfully. Optional.\n    *session_id* - An opaque string as far as the server is concerned that\n    is intended solely to allow async clients to differentiate different\n    results more easily. Optional.\n    *json* - requests that results be returned in JSON format rather than\n    XML.\n    *callback* - Supplies a JSONP callback. Optional and if given the\n    results are returned in JSONP format rather than XML.\n\n  Specific for this script\n    *suid* - ID(s) of the root Structural Unit(s) for which we need to\n    return ratings.\n\nRESULTS\n        The script returns an XML or JSON\/JSONP document (depending on\n        whether *json* or *callback* parameters have been set in the\n        request). The response contains a list of ratings, one rating per\n        structural unit. Each rating specifies the structural unit ID, and\n        counts of the good and bad ratings from that SU.\n\nSEE ALSO\n        EditSURating\n\n        LUMP-XML-Response\n\nCOPYRIGHT\n        Copyright 2012 Loughborough University Library\n        &lt;library@lboro.ac.uk&gt;.\n\n        Permission is granted to copy, distribute and\/or modify this\n        document under the terms of the GNU Free Documentation License,\n        Version 1.2 or any later version published by the Free Software\n        Foundation; with no Invariant Sections, with no Front-Cover Texts,\n        and with no Back-Cover Texts.\n\n<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>NAME GetSURating &#8211; Return the number of good\/bad ratings from users. DESCRIPTION The GetSURating CGI script allows rating from end users for one or more Structural Units to be returned in XML format. PARAMETERS Standard *username* &#8211; Name of user running this CGI script. Required unless web server authentication is in use (when it is, [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":125,"menu_order":3,"comment_status":"closed","ping_status":"closed","template":"page-col-1.php","meta":{"footnotes":"","_links_to":"","_links_to_target":""},"class_list":["post-1373","page","type-page","status-publish","hentry","count-0","even alt","author-lbjlclboro-ac-uk","last"],"_links":{"self":[{"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/pages\/1373","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/comments?post=1373"}],"version-history":[{"count":0,"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/pages\/1373\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/pages\/125"}],"wp:attachment":[{"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/media?parent=1373"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}