API
  • Yumpu documentations
  • JS
    • Introduction
    • Quick setup
    • Magazine example's
    • Bookshelf example's
    • FAQs
  • API
    • Introduction
    • Getting started
      • API token
      • Document API
      • User API
      • Search API
      • Install SDK's
    • Limits
    • Flowchart of basic processes
    • Documents
      • Get
    • Document
      • Get
      • Post file
      • Post url
      • Put
      • Delete
    • Document hotspots
      • Get
    • Document hotspot
      • Get
      • Post
      • Put
      • Delete
    • Document progress
      • Get
    • Document categories
      • Get
    • Document languages
      • Get
    • Countries
      • Get
    • Collections
      • Get
    • Collection
      • Get
      • Post
      • Put
      • Delete
    • Section
      • Get
      • Post
      • Put
      • Delete
    • Section document
      • Post
      • Delete
    • Search
      • Get
    • User
      • Get
      • Post
      • Put
    • Embeds
      • Get
    • Embed
      • Get
      • Post
      • Put
      • Delete
    • Members
      • Get
    • Member
      • Get
      • Post
      • Put
      • Delete
    • Access tags
      • Get
    • Access tag
      • Get
      • Post
      • Put
      • Delete
    • Subscriptions
      • Get
    • Subscription
      • Get
      • Post
      • Put
      • Delete
Powered by GitBook
On this page
  • Retrieve an existing hotspot
  • Parameters:
  • Demo

Was this helpful?

  1. API
  2. Document hotspot

Get

PreviousDocument hotspotNextPost

Last updated 3 years ago

Was this helpful?

Retrieve an existing hotspot

Parameters:

Name

Optional / Required

Data type

Description

Default

id

required

String

One of your document hotspot ids

return_fields

optional

String

Customize the responses by setting the return fields (id, document_id, page, type, settings, create_date, update_date)

id, document_id, page, type, settings, create_date, update_date

Demo

URL Find your token on - Token

id

Optional parameters:

return_fields

Add optional parametersRun request

Example:

curl -X GET -H "X-ACCESS-TOKEN: YOUR_ACCESS_TOKEN" "https://api.yumpu.com/2.0/document/hotspot.json?id=18414788HxIRKIoB"

Example:

require_once('../yumpu.php');
$yumpu = new Yumpu();
$data = array(
 'id' => '18414788HxIRKIoB'
);
$listHotspot = $yumpu->getDocumentHotspot($data);
print_r($listHotspot);

Example:

var yumpu = require('yumpu');
yumpu.setToken('yourToken');
var parameters = {
   id: '18414788HxIRKIoB'
};
yumpu.getDocumentHotspot(parameters, function(statusCode, document){
   console.log('Status: ' + statusCode);
   console.log(document);
});

Example:

Yumpu y = new Yumpu("your access token");
String[] params = {"id=18414788HxIRKIoB"};
System.out.println(y.getDocumentHotspot(params));

Whatever language you are using, the result will be the same.

{
  "hotspot": [
    {
      "id": "18414788HxIRKIoB",
      "document_id": "27109085",
      "page": "1",
      "type": "link",
      "settings": {
        "x": "0",
        "y": "0",
        "w": "400",
        "h": "100",
        "name": "www.yumpu.com",
        "tooltip": "www.yumpu.com",
        "link": "https://www.google.com"
      },
      "create_date": "2014-09-23 07:17:39",
      "update_date": "2014-09-23 07:20:21"
    }
  ],
  "state": "success",
  "completed_in": "0.1853"
}
yumpu.com