Guides

White label uploader

It is possible to integrate the Whitelabel Probo uploader with your solution.

Generate an uploader session

An uploader session requires a calculation_id, which gets returned by a (completed) product configuration or via the price request.

You can use this calculation_ID in combination with a callback_url to create an uploader session.

In the response of the uploader session, you will receive, amongst others, the ID, external_id, and a direct URL to the uploader session.

You must store the ID and external_id, as you need these in the order completion. You can serve the URL so your users can use this to upload their files.

Please monitor the callbacks to make sure an uploader session is approved.

Uploader create call


{
  "calculation_id": 68937,
  "callback_url": "http://example.com/uploader-callback",
  "language": "nl"
}

Optionally, the default language for the Reseller's account can be overruled by setting a language for the uploader. Use the ISO 639-1 standard for language code.

Response callback


{
  "calculation_id": 68937,
  "callback_url": "http://example.com/uploader-callback",
  "language": "nl"
}{
  "status": "confirmed",
  "products": [
    {
      "tiling_format": "none",
      "tiles_horizontal": 0,
      "tiles_vertical": 0,
      "tiles": [],
      "id": 5302843,
      "front_side": {
        "file": {
          "status": "not_converted",
          "preview_url": "2395541/4a2a10ac39b0deb0/4a2a10ac39b00_preview.jpg",
          "preview_medium_url": "2395541/4a2a10ac39b0deb0/4a2a19b0deb0_medium.jpg",
          "original_file_url": "2395541/4a2a10ac39b0deb0/4a2a10b0deb0.jpg",
          "production_file_url": "2395541/4a2a10ac39b0deb0/4a2a139b0deb0.pdf",
          "file_name": "jpeg.jpg",
          "original_file_hash": "4a2a1039b0deb0",
          "size_in_bytes": 111553,
          "dpi": 72,
          "page": 1,
          "is_booklet": false
        },
        "warnings": [
          "wrong_size"
        ],
        "dpi": 72,
        "custom_options": {
          "format": "original",
          "mirror": false,
          "rotation": 0
        }
      },
      "amount": 1
    }
  ],
  "Standard_tiling": "optimal",
  "tiling_format": "none",
  "id": 2395541,
  "external_id": 67,
  "variable_data": false
}

Placing an order with an uploader session.

When all uploader sessions have been confirmed and/or processed, the order can be posted by specifying the uploader_id and external_id

Add uploaders to call

{
  "products": [
    {
      "code": "banner-510",
      "options": [
        {
          "code": "width",
          "value": 100
        },
        {
          "code": "height",
          "value": 100
        },
        {
          "code": "amount",
          "value": 1
        },
        {
          "code": "finishing-all-sides"
        },
        {
          "code": "cut"
        }
      ],
      "uploaders": [
        {
          "id": 123456,
          "external_id": 654321
        }
      ]
    }
  ]
}