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

y or n

settings[background_opacity]

optional

String

0 to 1

settings[background_color]

optional

String

Hexadecimal value, 6 characters. #000000 - #FFFFFF

settings[hideborder]

optional

String

y or n

settings[asarea]

optional

String

y or n

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"

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"
}

Last updated