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
  • Update a document hotspot
  • Parameters:

Was this helpful?

  1. API
  2. Document hotspot

Put

Update a document hotspot

Parameters:

Name

Optional / Required

Data type

Description

Default

id

required

String

One of your document hotspot ids

type

required

String

Type can be link, video, audio or slideshow

settings[x]

required

Integer

x position of the document hotspot

settings[y]

required

Integer

y position of the document hotspot

settings[w]

required

Integer

width of the document hotspot

settings[h]

required

Integer

height of the document hotspot

settings[name]

required

String

a name for the document hotspot (min. length 5, max. length 50)

settings[tooltip]

required

String

a tooltip for the document hotspot (min. length 5, max. length 50)

settings[link]

optional

String

a url (valid URL)

settings[source]

optional

String

youtube, vimeo, flickr, soundcloud

settings[source_id]

optional

String

youtube: a valid youtube video id vimeo: a valid vimeo video id flickr: a valid flickr id

settings[source_url]

optional

String

soundcloud: a valid soundcloud url

settings[autoplay]

optional

String

y or n

settings[show_arrows]

optional

String

y or n

settings[show_headline]

optional

String

y or n

settings[object_fit]

optional

String

"cover" or "contain"

settings[background_opacity]

optional

Float

0.0 to 1

settings[background_color]

optional

String

Hexadecimal value, 6 characters. #000000 - #FFFFFF

settings[background_color_hover]

optional

String

Hexadecimal value, 6 characters. #000000 - #FFFFFF

settings[background_color_hover_opacity]

optional

Float

0.0 to 1

settings[hideborder]

optional

String

y or n

settings[asarea]

optional

String

y or n

settings[icon_color]

optional

String

Hexadecimal value, 6 characters. #000000 - #FFFFFF

settings[icon_opacity]

optional

Float

0.0 to 1

settings[icon_color_hover]

optional

String

Hexadecimal value, 6 characters. #000000 - #FFFFFF

settings[icon_color_hover_opacity]

optional

Float

0.0 to 1

settings[icon_size]

optional

Integer

(min 14) - (max 64)

settings[icon_url]

optional

String

See below for available icons

Icons (currently only available for the Link and Audio elements)

  • fa-link

  • fa-link-simple

  • fa-link-horizontal

  • fa-arrow-up-right-from-square

  • fa-square-arrow-up-right

  • fa-dollar-sign

  • fa-euro-sign

  • fa-sterling-sign

  • fa-money-bill-wave

  • fa-credit-card

  • fa-cart-shopping

  • fa-bag-shopping

  • fa-basket-shopping

  • fa-cart-plus

  • fa-shop

  • fa-store

  • fa-globe

  • fa-envelope

  • fa-comments

  • fa-info

  • fa-user

  • fa-book

  • fa-map-location-dot

  • fa-play

  • fa-music

  • fa-volume

  • fa-volume-low

  • fa-volume-high

  • fa-headphones

  • fa-play-pause

  • fa-podcast

  • fa-repeat

  • fa-microphone

  • fa-microphone-lines

  • fa-speaker

Example:

curl -X PUT -H "X-ACCESS-TOKEN: YOUR_ACCESS_TOKEN" -d "id=02608658TXrk4GRB" -d "type=link" -d "settings[x]=0" -d "settings[y]=0" -d "settings[w]=400" -d "settings[h]=100" -d "settings[name]=Google.com" -d "settings[tooltip]=Google.com" -d "settings[link]=https://www.google.com" "https://api.yumpu.com/2.0/document/hotspot.json"

Example:

require_once('../yumpu.php');
$yumpu = new Yumpu();
$data = array(
    'id' => '02784dc6chuNtFd2',
    'type' => 'link',
    'settings' => array(
        'x' => 200,
        'y' => 200,
        'w' => 20,
        'h' => 20,
        'name' => 'google.com',
        'tooltip' => 'google.com',
        'link' => 'https://www.yumpu.com'
    )
);
$hotspot = $yumpu->putDocumentHotspot($data);
print_r($hotspot);

Example:

var yumpu = require('yumpu');
yumpu.setToken('yourToken');
var parameters = {
   id: '02608658TXrk4GRB',
   page: 1,
   type: 'link',
   settings: {
       x: 100,
       y: 100,
       w: 50,
       h: 50,
       name: 'google.com',
       tooltip: 'google.com',
       link: 'https://www.yumpu.com'
   }
};
yumpu.putDocumentHotspot(parameters, function(statusCode, document){
   console.log('Status: ' + statusCode);
   console.log(document);
});

Example:

Yumpu y = new Yumpu("your access token");
String[] params = {"document_id=27109085", "type=link", "page=1"};
String[] settings = {"x=0", "y=0", "w=400", "h=400", "name=google.com", "tooltip=google.com", "link=https://www.yumpu.com"};
System.out.println(y.putDocumentHotspot(params, settings));

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

{
  "hotspot": [
    {
      "id": "02608658TXrk4GRB",
      "document_id": "27219350",
      "page": "1",
      "type": "link",
      "settings": {
        "x": "0",
        "y": "0",
        "w": "400",
        "h": "100",
        "name": "google.com",
        "tooltip": "google.com",
        "link": "https://www.yumpu.com"
      },
      "create_date": "2014-10-01 08:53:57",
      "update_date": "2014-10-01 09:09:00"
    }
  ],
  "state": "success",
  "completed_in": "0.1644"
}
PreviousPostNextDelete

Last updated 5 days ago

Was this helpful?