ODS Bookmarks 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 here.

  1. Go to http://demo.openlinksw.com/ods
  2. Log in as user demo with password demo
  3. Go to Settings->OAuth Keys
  4. Copy the Token value for an Bookmark instance or create such in not existing. For ex.: 3c9dc72d97a67e4f4dbd5d36e4dae0bda32ebdf1
  5. Go to http://demo.openlinksw.com/ods/oauth_test.vsp
  6. In the shown form enter for:
    1. Server: http://demo.openlinksw.com/ods/api
    2. Consumer Key: 3c9dc72d97a67e4f4dbd5d36e4dae0bda32ebdf1
    3. API method: bookmark.new
    4. 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 ODS Framework Controller instance.get.id:

        $ curl -i "http://demo.openlinksw.com/ods/api/instance.get.id?user_name=demo&password_hash=4627dhe23cb53f522eag32e09gs7fceaw2c523449bdfdf&instanceName=mybookmarks" HTTP/1.1 200 OK Server: Virtuoso/06.03.3131 (Linux) x86_64-generic-linux-glibc25-64 VDB Connection: Keep-Alive Date: Sun, 05 Feb 2012 21:01:20 GMT Accept-Ranges: bytes Content-Type: text/xml; charset="UTF-8" Content-Length: 58 <result> <code>7</code> <message>Success</message> </result>

      • You can also get the instance id using the ODS Ubiquity commands sequence:

        ods-host http://demo.openlinksw.com/ods ods-set-mode sid ods-authenticate-user demo password demo ods-get-instance-id mybookmarks

    5. Select for Query options: "Generate URI and Submit".
  7. Click the "Execute" button.
  8. Enter the password for user demo and click the "Login" button.
  9. In the shown authorization form click the "Authorize" button.
  10. 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
  11. Now lets get the data for the created bookmark. In the form enter:
    1. API method: bookmark.get
    2. API parameters: bookmark_id=1989
    3. Select for Query options: "Generate URI and Submit".
  12. Click the "Execute" button.
  13. As result in the "Response Body" text-area will be shown the retrieved details for the bookmark with the given above id.


CategoryBookmark CategoryODS