The API uses deprecated terminology in the request and response parameters. What we previously referred to as "bookmarks in a folder" is actually just "documents in a stack". So to list all the documents in a specific stack you would use the Bookmark List API with a specific folder id.
A folder is just deprecated terminology for a stack (see above).
The folderId request parameter is simply the stack id formatted with hyphens to form a valid UUID.
For example the stack id
123e4567e89b12d3a456426655440000 corresponds to folder id
You find the stack id in the URL when you click a stack from your profile page
The document location on issuu.com is defined by two parameters: The
username of your account and the
name of the document
If you want the document to open on a specific page you can append the page number
The API will not return the document URL directly so instead you need to pick out the
username and document
name from the response and manually construct the URL.
Note: The URLs above are for showing the document on the issuu.com web page which will include ads and related content.
If you are on a paid plan ("Starter" or above) you can show your document without any distractions by appending
mode=embed to the URL
The current version of the API will not return image links to the document cover but given the documentId identifier a URL can be constructed
Note: If you re-upload or delete the document the image URL will cease to work.
Unfortunately this is not currently possible via the API. Instead you will need to use the Publisher Suite on issuu.com to achieve this.
However, if you do regular uploads (of say weekly or monthly editions) you can use a single embed code on your web page and use the Embed Update API with the
documentId parameter to dynamically change the document that is being displayed.
This functionality is currently being ported to the API. Please check this spot for updates.
No, unfortunately not. You can change the download setting for a document using the Document Update API but the actual download will always need to be done via the document page or embed.