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:

Name	Required	Description	DataType	Example
projectKey	Yes	Unique Identifier for the finished project as received in the request in Sale Notification	Integer	492393
files	Yes	Array 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"]
output	Yes	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 `front` or `back` (for logo products), or `bookCover` or `innerPages` (for photobooks) `proofUrls` - An array of URLs (strings) that point to the print proof files (only for logo products). `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" } ]
uploads	No (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"]
callbackUrl	No	When 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:

Last updated on

Was this page helpful?