%VOSWARNING%


---++Polls OAuth REST API Example performed with the Virtuoso OAuth Testing Tool

The following example demonstrates adding and getting poll by the ODS REST APIs *poll.new* and *poll.get* using the OAuth Test Tool. Full list of the ODS REST APIs for ODS Polls you can find [[VirtuosoOdsControllersPolls][here]].

   1. Go to http://demo.openlinksw.com/ods
   1. Log in as user demo with password demo
   1. Go to Settings->OAuth Keys
      * <img src="%ATTACHURLPATH%/o1.png" style="wikiautogen"/>
   1. Copy the Token value for an Polls instance or create such in not existing. For ex.: cb0c9e0335fa088f7c779b0fec826b5a6af120c4
   1. Go to http://demo.openlinksw.com/ods/oauth_test.vsp
   1. In the shown form enter for:
      1. *Server*: http://demo.openlinksw.com/ods/api
      1. *Consumer Key*: cb0c9e0335fa088f7c779b0fec826b5a6af120c4
      1. *API method*: poll.new
      1. *API parameters*: inst_id=61&name=MyPoll
         * An easy way to get the instance id is using the [[VirtuosoOdsUbiquity][ODS ubiquity commands]] sequence:
<verbatim>
ods-host http://demo.openlinksw.com/ods
ods-set-mode sid
ods-authenticate-user demo password demo
ods-get-instance-id mypolls
</verbatim>
      1. Select for *Query options*: "Generate URI and Submit".
      * <img src="%ATTACHURLPATH%/op1.png" style="wikiautogen"/>
   1. Click the "Execute" button.
   1. Enter the password for user demo and click the "Login" button.
   1. In the shown authorization form click the "Authorize" button.
      * <img src="%ATTACHURLPATH%/op2.png" style="wikiautogen"/>
   1. As result will be shown the generated URI and the output message of executing the ODS REST API. In our case, the id of the new created poll will be: 1012
      * <img src="%ATTACHURLPATH%/op3.png" style="wikiautogen"/>
   1. Now lets get the data for the created poll. In the form enter:
      1. *API method*: poll.get
      1. *API parameters*: poll_id=1012
      1. Select for *Query options*: "Generate URI and Submit".
   1. Click the "Execute" button.
   1. As result in the "Response Body" text-area will be shown the retrieved details for the poll with the given above id.
      * <img src="%ATTACHURLPATH%/op4.png" style="wikiautogen"/>  

CategoryPolls CategoryODS