File Delivery

Once the print file has been generated by FastEditor, we need to share the file location of the print-ready files. You therefore need to implement a handle that can receive this request from FastEditor.

Endpoint(s)

The endpoints for this request (for test/staging/production environments) should be provided by you and shared with your account manager at FastEditor.

Authorization

When sending the shopping cart payload to your endpoint, we will add the X-Api-Key header to the request so you can verify the sender. The value of this X-Api-Key will be shared by your account manager on start start of the integration process.

Request

This request body is a JSON objects with the following parameters:

NameRequiredDescriptionDataTypeExample
projectKeyYesUnique Identifier for the finished project as received in the request in Sale NotificationInteger492393
filesYesArray with the download URLs of the files required for printing. This could be a single PDF file for a photobook, or an array of images for a set of prints.Array["https://printfiles.com/generatedbook.pdf"]
outputYes

The output field contains an array of objects. Each object represents a single page or section of the project and includes:

  • name – A string identifying the page or section, such as "bookCover" or "innerPages".
  • printFiles – An array of URLs (strings) that point to the print-ready file(s) for that page or section.
  • printMethod – A string describing the printing method used, for example "Digital printing".
Array

[

{

"name": "bookCover",

"printFiles": [

"https://order-fulfillment-staging-documents-fasteditor.s3.amazonaws.com/25/240_387_FSF2nXZRmNrqSwQAAila/10111132/v1755077001/cover.pdf"

],

"printMethod": "Digital printing"

},

{

"name": "innerPages",

"printFiles": [

"https://order-fulfillment-staging-documents-fasteditor.s3.amazonaws.com/25/240_387_FSF2nXZRmNrqSwQAAila/10111132/v1755077001.pdf"

],

"printMethod": "Digital printing"

}

]

uploadsNo (only for logo products)Array of URLs to the original uploads made by the user. This is only shared for logo products so that this can be used to check vectorization results.Array"[https://useruploads.com/logo.eps"]
callbackUrlNoWhen provided in the Sale Notification the callback Url where the print files were sent to is returned here.String"https://fast-editor.yspacc.com/v1/projects/file-delivery"

Response

We will check for a successful (201) response header to this request so we know the data was received and saved correctly.

Example Request

Below an example request to your File Delivery endpoint:

Copy
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard