Put

Update an existing document

Parameters:

Name

Optional / Required

Data type

Description

Default

id

required

Integer

One of your document ids

title

required

String

A title for your document. Min. length 5 characters, max. length 255 characters

description

optional

String

A description for your document. Min. length 5 characters, max. length 2500 characters

category

optional

Integer

1, 2 or ... (A list of valid category ids: Document categories)

0 = None

language

optional

String

en, de or ... (A list of valid languages: Document languages)

en

tags

optional

String

A list of words seperated by comma (house,garden,balcony). Min. length 3 characters, max. length 30 characters. Allowed characters a-z and a space.

Autogenerated by tag service

visibility

optional

String

public, private, rprotected, pprotected, dprotected, webkiosk, appkiosk or webappkiosk (rprotected = protected by referrer, pprotected = protected by password, dprotected = protected by domain(s))

public

validity

optional

String

Valid from and / or valid until Examples: 2013-10-01T00:00:00-2013-10-30T23:59:59 (valid from 2013-10-01 00:00:00, valid until 2013-10-30 23:59:59) 2013-10-01T00:00:00- (valid from 2013-10-01 00:00:00-) -2013-10-30T23:59:59 (valid until -2013-10-30 23:59:59)

downloadable

optional

String

Allow users to download your source pdf file. y or n

n

recommended_magazines

optional

String

Show recommended magazines on Yumpu? y or n

y

social_sharing

optional

String

Show social sharing buttons on Yumpu. y or n

y

site_pageview

optional

String

Show document in single or double pageview. double or single

double

player_social_sharing

optional

String

Show social sharing buttons in Yumpu Player. y or n

y

player_download_pdf

optional

String

Show button "download pdf" in Yumpu Player. y or n

n

player_print_page

optional

String

Show button "print page" in Yumpu Player. y or n

n

player_branding

optional

String

Show Yumpu branding in Yumpu Player. y or n

y

player_sidebar

optional

String

Show a list of recommended documents in Yumpu Player. y or n

n

player_html5_c2r

optional

String

Activate HTML5 full screen on Yumpu. y or n

y

player_outer_shadow

optional

String

Drop shadow in Yumpu player. y or n

y

player_inner_shadow

optional

String

Shadow effects on pages. y or n

y

player_ga

optional

String

Activate Google Analytics tracking. A valid UA code from Google Analytics.

access_tags

optional

String

One or multiple access_tag ids (myid1 or myid1,myid2)

subscriptions

optional

String

One or multiple subscription ids (myid1 or myid1,myid2)

iap

optional

String

Enable In-App Purchase (y or n)

n

itc_product_id

optional

String

iTunes Product ID

curl
PHP
JavaScript
Java
curl

Example:

curl -X PUT -H "X-ACCESS-TOKEN: YOUR_ACCESS_TOKEN" -d "id=20582984" -d "title=My new document title" "http://api.yumpu.com/2.0/document.json"
PHP

Example:

require_once('../yumpu.php');
$yumpu = new Yumpu();
$data = array(
'id' => 20582984,
'title' => 'My new document title'
);
$putDocument = $yumpu->putDocument($data);
print_r($putDocument);
JavaScript

Example:

var yumpu = require('yumpu');
yumpu.setToken('yourToken');
var parameters = {
id: '20582984',
title: 'My new document title'
};
yumpu.putDocument(parameters, function(statusCode, document){
console.log('Status: ' + statusCode);
console.log(document);
});
Java

Example:

Yumpu y = new Yumpu("your access token");
String[] params = {"id=20582984", "title=My new document title"};
System.out.println(y.putDocument(params));

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

{
"document": [
{
"id": 20582984,
"create_date": "2016-09-13 09:13:15",
"update_date": "2016-09-13 09:17:23",
"url": "http://www.yumpu.com/de/document/view/55932706/new-title-2",
"short_url": "http://www.yumpu.com/s/Ok8tEcVRDCsfAod0",
"image": {
"small": "http://img.yumpu.com/55932706/1/115x163/new-title.jpg",
"medium": "http://img.yumpu.com/55932706/1/452x640/new-title.jpg",
"big": "http://img.yumpu.com/55932706/1/1129x1600/new-title.jpg"
},
"language": "de",
"title": "My new document title",
"description": "",
"pages": 3,
"width": 452,
"height": 640,
"tags": [
"suchparameter",
"liefert",
"google",
"webseiten",
"suchbegriff",
"mehreren",
"angezeigt",
"beschreibung",
"nutzwert",
"treffer",
"www.lukasbals.at"
],
"embed_code": "<iframe width=\"512px\" height=\"384px\" src=\"https://www.yumpu.com/de/embed/view/CsdA9tSUlmyVvbNO\" frameborder=\"0\" allowfullscreen=\"true\" allowtransparency=\"true\"></iframe>",
"settings": {
"date_validity_from": "",
"date_validity_until": "",
"site_social_sharing": true,
"privacy_mode": "public",
"site_download_pdf": false,
"site_recommended_magazines": true,
"player_download_pdf": false,
"player_print_page": false,
"player_branding": true,
"player_sidebar": false,
"player_social_sharing": true,
"player_google_analytics_code": "",
"player_html5_c2r": true,
"player_outer_shadow": true,
"player_inner_shadow": true,
"appkiosk_itc_product_id": "",
"appkiosk_iap_sale_item": false,
"magazine_premium_blurred": false,
"magazine_premium_blurred_page_range": "",
"magazine_page_teaser": false,
"magazine_page_teaser_page_range": "",
"magazine_page_teaser_url": "",
"magazine_page_teaser_image_url": "",
"magazine_acl_running": false,
"player_zoom_factor": 2.5,
"hotspoteditor_custom": false
},
"access_tags": false,
"subscriptions": false
}
],
"state": "success",
"status_code": 200,
"completed_in": 0.8976
}