A
A
API
Search
K

Get

Retrieve a list of your hotspots

Parameters:

Name
Optional / Required
Data type
Description
Default
id
required
Integer
One of your document ids
page
optional
Integer
Filter the results by page nr (1 - X)
offset
optional
Integer
Retrieve rows at position X (min. 0)
0
limit
optional
Integer
Retrieve X rows (min. 0 and max. 100)
10
sort
optional
String
Sort results by create_date_desc, create_date_asc, page_desc, page_asc
page_asc
return_fields
optional
String
Customize the responses by setting the return fields (id, page, type, settings, create_date, update_date)
id, page, type, settings, create_date, update_date

Demo

URL Find your token on - yumpu.com Token
document id

Optional parameters:

page offset limit sort return_fields
Add optional parametersRun request
curl
PHP
JavaScript
Java
Example:
curl -X GET -H "X-ACCESS-TOKEN: YOUR_ACCESS_TOKEN" "https://api.yumpu.com/2.0/document/hotspots.json?id=27109037&limit=1"
Example:
require_once('../yumpu.php');
$yumpu = new Yumpu();
$data = array(
'id' => 27109085,
'limit' => 1
);
$listHotspots = $yumpu->getDocumentHotspots($data);
print_r($listHotspots);
Example:
var yumpu = require('yumpu');
yumpu.setToken('yourToken');
var parameters = {
id: 27109037,
offset: 0,
limit: 1
};
yumpu.getDocumentHotspots(parameters, function(statusCode, document){
console.log('Status: ' + statusCode);
console.log(document);
});
Example:
Yumpu y = new Yumpu("your access token");
String[] params = {"id=27109037", "limit=1"};
System.out.println(y.getDocumentHotspots(params));
Whatever language you are using, the result will be the same.
{
"total": 74,
"hotspots": [
{
"id": "fc62e52bphzHaVqn",
"document_id": 27109037,
"page": 1,
"type": "link",
"settings": {
"x": 311,
"y": 603,
"w": 109,
"h": 8,
"name": "www.yumpu.com",
"link": "https://www.yumpu.com",
"tooltip": "www.yumpu.com"
},
"create_date": "2016-09-13 09:13:19",
"update_date": "0000-00-00 00:00:00"
}
],
"state": "success",
"completed_in": 0.0922
}