issuu.bookmark.update

Update title or description of a bookmark.

Authentication

This method requires authentication.

Request parameters

Name Data type Description
apiKey string Application key for the account
signature string See Signing Requests
bookmarkId string The bookmark to be updated
title string New title of the bookmark. If this parameter is omitted the original title will be kept
description string New description of the bookmark. If this field is omitted the original description will be kept. Max length: 1000 characters.
format enum Must be "xml" or "json" - default is "xml". See Getting Started for further details
jsonCallback string Function wrapper for JSONP requests. See Getting Started for further details

Here is a basic example of an HTML form.

<form action="http://api.issuu.com/1_0" method="post">
  <input type="hidden" name="action" value="issuu.bookmark.update"/>
  <input type="hidden" name="apiKey" value="g0ch5rj9ywztlo022w70naymutm2fbbg"/>
  <input type="hidden" name="bookmarkId" value="11b27cd5-ecdc-4c39-b818-8f3c8eca443c"/>
  <input type="text" name="title"/>
  <input type="text" name="description"/>
  <input type="submit" value="Update"/>
</form>

Response parameters

Name Data type Description
bookmarkId string Unique identifier for the bookmark
username string Owner of the bookmark
documentId string The document bookmarked
documentUsername string Owner of the bookmarked document
name string Name of the bookmarked document
title string Title of the bookmark
description string Description of the bookmark
page integer The page in the document that was bookmarked
created date Timestamp for when bookmark was created
folders list List of folders this bookmark has been added to

Example responses

<rsp stat="ok">
  <bookmark bookmarkId="11b27cd5-ecdc-4c39-b818-8f3c8eca443c" username="travelmagazine" documentId="081024182109-9280632f2866416d97634cdccc66715d" documentUsername="publination" name="wildswim" title="Wild Swim: The best outdoor swims across Britain" description="Wild Swim by Kate Rew is the definitive guide to over 300 beautiful outdoor swims in rivers, lakes, tidal pools, the sea and lidos across Britain. By the founder of the Outdoor Swimming Society." page="1" created="2009-06-22T07:54:17.000Z">
    <folders>
      <folder id="52ab7b36-946d-45b2-a446-f95e84b2682e"/>
    </folders>
  </bookmark>
</rsp>
{
    "rsp": {
        "_content": {
            "bookmark": {
                "bookmarkId": "11b27cd5-ecdc-4c39-b818-8f3c8eca443c",
                "username": "travelmagazine",
                "documentId": "081024182109-9280632f2866416d97634cdccc66715d",
                "documentUsername": "publination",
                "name": "wildswim",
                "title": "Wild Swim: The best outdoor swims across Britain",
                "description": "Wild Swim by Kate Rew is the definitive guide to over 300 beautiful outdoor swims in rivers, lakes, tidal pools, the sea and lidos across Britain. By the founder of the Outdoor Swimming Society.",
                "page": 1,
                "created": "2009-06-22T07:54:17.000Z",
                "folders": [
                    "52ab7b36-946d-45b2-a446-f95e84b2682e"
                ]
            }
        },
        "stat": "ok"
    } 
}

 

Error codes

Code Message
009 Authentication required
010 Invalid API key
200 Required field is missing
201 Invalid field format