%VOSWARNING%


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

The following example demonstrates adding and getting bookmark info by the ODS REST APIs *bookmark.new* and *bookmark.get* using the OAuth Test Tool. Full list of the ODS REST APIs for ODS Bookmark you can find [[VirtuosoOdsControllersBookmarks][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 Bookmark instance or create such in not existing. For ex.: 3c9dc72d97a67e4f4dbd5d36e4dae0bda32ebdf1 
   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*: 3c9dc72d97a67e4f4dbd5d36e4dae0bda32ebdf1
      1. *API method*: bookmark.new
      1. *API parameters*: inst_id=7&uri=http://www.openlinksw.com/blog/~kidehen&name=Kingsley Idehen's Weblog
         * 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 mybookmarks
</verbatim>
      1. Select for *Query options*: "Generate URI and Submit".
      * <img src="%ATTACHURLPATH%/ob1.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%/ob2.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 bookmark will be: 1989
      * <img src="%ATTACHURLPATH%/ob3.png" style="wikiautogen"/>
   1. Now lets get the data for the created bookmark. In the form enter:
      1. *API method*: bookmark.get
      1. *API parameters*: bookmark_id=1989
      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 bookmark with the given above id.
      * <img src="%ATTACHURLPATH%/ob4.png" style="wikiautogen"/>  

CategoryBookmark CategoryODS