Get

PreviousCollection NextPost

Last updated 3 years ago

Was this helpful?

Retrieve an existing collection

Parameters:

Name

Optional / Required

Data type

Description

Default

required

String

One of your collection ids

return_fields

optional

String

Customize the responses by setting the return fields (id, create_date, update_date, name, order, sections)

id, create_date, update_date, name, order, sections

Demo

URL Find your token on - Token

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/collection.json?id=iMWWKoMS76pjqMoO"

Example:

require_once('../yumpu.php');
$yumpu = new Yumpu();
$data = array(
    'id' => 'iMWWKoMS76pjqMoO',
);
$listCollection = $yumpu->getCollection($data);
print_r($listCollection);

Example:

var yumpu = require('yumpu');
yumpu.setToken('yourToken');
var parameters = {
  id: 'iMWWKoMS76pjqMoO',
  return_fields: 'id,create_date,update_date,name,order,sections'
};
yumpu.getCollection(parameters, function(statusCode, document){
   console.log('Status: ' + statusCode);
   console.log(document);
});

Example:

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

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

{
  "collection": [
    {
      "id": "iMWWKoMS76pjqMoO",
      "create_date": "2013-09-23 08:01:01",
      "update_date": "2013-09-23 08:01:35",
      "name": "My magazines",
      "order": 0,
      "sections": [
        {
          "id": "iMWWKoMS76pjqMoO_2mqhaSEMTVpvFwrY",
          "name": "Top 3",
          "description": "Top 3",
          "sorting": "manually",
          "order": 0
        },
        {
          "id": "iMWWKoMS76pjqMoO_vpgFQQ3sHervO8yj",
          "name": "Look at that",
          "description": "Look at that",
          "sorting": "title_desc",
          "order": 1
        }
      ]
    }
  ],
  "state": "success"
}