Editor Label API Reference 1.0.0 GNU GPLv3

Fasteditor API reference for white Label Administrators

Server

https://{domain_url}/api

Server Variables

Authentication

The request needs to include an X-Api-Key header. Make sure this header is not exposed to the browser, so this request needs to be initiated from the backend.

Fields

Key	In
X-Api-Key	Header

Shopping Cart Item

DELETE

/shoppingcartitem/{id}

Delete Shoppingcartitem

Auth

Path Params

integer

Shoppingcartitem unique id

DELETE /shoppingcartitem/{id}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://api.editor.staging.fasteditor.com/api/shoppingcartitem/%7Bid%7D' \ --header 'X-Api-Key: {X-Api-Key}'
Copy

Responses

200

Deleted

No response body

Response

xxxxxxxxxx
 
No response
Copy

Partner-user

/partner/user/products

Update user Id

Update user id

Auth

Request Body

Root Type for update_userid_body	object
currentUserId	string
newUserId	string

PUT /partner/user

xxxxxxxxxx
 
curl --request PUT \ --url 'https://api.editor.staging.fasteditor.com/api/partner/user' \ --header 'X-Api-Key: {X-Api-Key}' \ --data '{  "currentUserId": "auth0|663a2ee7333e91e20581dd50",  "newUserId": "auth0|663a2ee7333e91e20581dd59"}'
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

Delete User

Delete User record

Auth

Query String

userid

string

User unique id

DELETE /partner/user

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://api.editor.staging.fasteditor.com/api/partner/user' \ --header 'X-Api-Key: {X-Api-Key}' \ --data userid=1234
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

Get User's Products

Auth

Query String

language	string
limit	integer
orderby	string
userid	string	The user's id

GET /partner/user/products

xxxxxxxxxx
 
curl --get \ --url 'https://api.editor.staging.fasteditor.com/api/partner/user/products' \ --header 'X-Api-Key: {X-Api-Key}' \ --data language=en \ --data limit=20 \ --data orderby={orderby} \ --data userid=auth0%7C59397e29568d8435eae3354f
Copy

Responses

200

Success

No response body

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
[ {  "id": 6686,  "title": "",  "lastUpdate": "2021-09-24 00:00:00",  "imageUrl": "http://localhost:8088/dev/project-image/2/6686/Q8aaUCR55VgqC6JAbKL9/1632434400",  "productUrl": "http://localhost:8080/app/6686/open",  "offeringName": "cadeauboekje met foto's",  "offeringDescription": "formaat 10x10 cm " }, {  "id": 6657,  "title": "",  "imageUrl": "http://localhost:8088/dev/project-image/2/6657/9Z2wGFSkDnnmrUw8K07t/1714722423",  "productUrl": "http://localhost:8080/app/6657/open",  "offeringName": "fotokaartje - 10x15 cm",  "offeringDescription": "direct verstuurd naar de ontvanger 2.- inclusief verzendkosten" }, {  "id": 6146,  "title": "",  "imageUrl": "http://localhost:8088/dev/project-image/2/6146/PVwb1g6B7j6yV0vt80EM/1714722423",  "productUrl": "http://localhost:8080/app/6146/open",  "offeringName": "melamine bordje",  "offeringDescription": "met eigen foto of tekst diverse designs" }, {  "id": 6147,  "title": "",  "imageUrl": "http://localhost:8088/dev/project-image/2/6147/qFfapi8FhnVu0sh44Rq5/1714722423",  "productUrl": "http://localhost:8080/app/6147/open",  "offeringName": "linnen placemat",  "offeringDescription": "met eigen foto of tekst formaat 26.5x38 cm" }, {  "id": 6664,  "title": "",  "imageUrl": "http://localhost:8088/dev/project-image/2/6664/0ig33QL2iQkiNaY6GvK1/1714722423",  "productUrl": "http://localhost:8080/app/6664/open",  "offeringName": "mobileprint  - Instax",  "offeringDescription": "formaat 6x9 cm set van 20" }, {  "id": 6665,  "title": "",  "imageUrl": "http://localhost:8088/dev/project-image/2/6665/pOPN0vWSC8F97ziTsiIV/1714722423",  "productUrl": "http://localhost:8080/app/6665/open",  "offeringName": "kaartspel met 54 foto's",  "offeringDescription": "verschillende foto's op de voorkant geleverd in een kunststof doosje" }, {  "id": 6666,  "title": "",  "imageUrl": "http://localhost:8088/dev/project-image/2/6666/PquvO7JBgkAoutVkJtf5/1714722423",  "productUrl": "http://localhost:8080/app/6666/open",  "offeringName": "snoepblik hart",  "offeringDescription": "met eigen foto of tekst verschillende designs" }, {  "id": 6667,  "title": "",  "imageUrl": "http://localhost:8088/dev/project-image/2/6667/RztuDJmG2ptXhJ50uKLx/1714722423",  "productUrl": "http://localhost:8080/app/6667/open",  "offeringName": "koektrommel",  "offeringDescription": "met eigen foto of tekst verschillende designs" }, {  "id": 6668,  "title": "",  "imageUrl": "http://localhost:8088/dev/project-image/2/6668/Ghd8dUmZGZSVk29MQm9P/1714722423",  "productUrl": "http://localhost:8080/app/6668/open",  "offeringName": "geheugenspel",  "offeringDescription": "2x30 foto's geleverd in een doosje" }, {  "id": 6669,  "title": "",  "imageUrl": "http://localhost:8088/dev/project-image/2/6669/zUP3ohrESlGiyiSOVZLu/1714722423",  "productUrl": "http://localhost:8080/app/6669/open",  "offeringName": "volledig bedrukte mok",  "offeringDescription": "met eigen foto of tekst verschillende designs" }]
Copy

Expand

Project

DELETE

/product/{id}

Delete Project

Delete a project created by a user

Auth

Path Params

integer

Project unique id

DELETE /product/{id}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://api.editor.staging.fasteditor.com/api/product/%7Bid%7D' \ --header 'X-Api-Key: {X-Api-Key}'
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

Shop Integration

/shop-integration/{id}

PUT

/shop-integration/{id}

PUT

/shop-integration/{id}/apikey

Read shop integrations

Retrieve all shop integrations

Auth

GET /shop-integration

xxxxxxxxxx
 
curl --get \ --url 'https://api.editor.staging.fasteditor.com/api/shop-integration' \ --header 'X-Api-Key: {X-Api-Key}'
Copy

Responses

200

Root Type for create-shop-integration_response	array[object]
id	int32
name	string
cartUrl	string
created	date-time
apiKey	string

Response

xxxxxxxxxx
 
[ {  "id": 1,  "name": "Shop A",  "cartUrl": "https://redirect.to/shop-a-cart-url",  "created": "2025-04-05 11:53:52",  "apiKey": "ftCympnHkbYoqXXOguI84Gj3UnmKji0ZD62DKV53" }, {  "id": 2,  "name": "Shop B",  "cartUrl": "https://redirect.to/shop-b-cart-url",  "created": "2025-04-07 13:52:52",  "apiKey": "PZMQnGdE4eEKmf0fUVRxu4m1IsN5rbUrqm3JFykO" }]
Copy

Create a Shop

Create a new shop integration for the FastEditor Label

Auth

Request Body

Root Type for create-shop-integration_response	object
id	int32
name	string
cartUrl	string
created	date-time
apiKey	string

POST /shop-integration

xxxxxxxxxx
 
curl --request POST \ --url 'https://api.editor.staging.fasteditor.com/api/shop-integration' \ --header 'X-Api-Key: {X-Api-Key}' \ --data '{  "name": "Name of the shop",  "cartUrl": "https://redirect.my.customer/to-this-cart-url"}'
Copy

Responses

201

Created

Root Type for create-shop-integration_response	object
id	int32
name	string
cartUrl	string
created	date-time
apiKey	string

Response

xxxxxxxxxx
 
{ "id": 1, "name": "Name of the shop", "cartUrl": "https://redirect.my.customer/to-this-cart-url", "created": "2025-04-05 11:53:52", "apiKey": "ftCympnHkbYoqXXOguI84Gj3UnmKji0ZD62DKV53"}
Copy

Read a shop integration

Read a specific shop integration record

Auth

GET /shop-integration/{id}

xxxxxxxxxx
 
curl --get \ --url 'https://api.editor.staging.fasteditor.com/api/shop-integration/{id}' \ --header 'X-Api-Key: {X-Api-Key}'
Copy

Responses

200

Root Type for shop	object
id	int32
name	string

Response

xxxxxxxxxx
 
{ "id": 1, "name": "Name of the shop", "cartUrl": "https://redirect.my.customer/to-this-cart-url", "created": "2025-04-05 11:53:52", "apiKey": "ftCympnHkbYoqXXOguI84Gj3UnmKji0ZD62DKV53"}
Copy

Update a shop integration

Update a specific shop integration record

Auth

Request Body

Root Type for shop-integration-body	object
name	string
cartUrl	string

PUT /shop-integration/{id}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://api.editor.staging.fasteditor.com/api/shop-integration/{id}' \ --header 'X-Api-Key: {X-Api-Key}' \ --data '{  "name": "Name of the shop",  "cartUrl": "https://redirect.my.customer/to-this-cart-url"}'
Copy

Responses

200

Root Type for create-shop-integration_response	object
id	int32
name	string
cartUrl	string
created	date-time
apiKey	string

Response

xxxxxxxxxx
 
{ "id": 1, "name": "Name of the shop", "cartUrl": "https://redirect.my.customer/to-this-cart-url", "created": "2025-04-07 13:52:52"}
Copy

Rotate Shop API key

Rotate the API key for a specific shop integration

Auth

Path Params

id integer

PUT /shop-integration/{id}/apikey

xxxxxxxxxx
 
curl --request PUT \ --url 'https://api.editor.staging.fasteditor.com/api/shop-integration/%7Bid%7D/apikey' \ --header 'X-Api-Key: {X-Api-Key}'
Copy

Responses

200

Root Type for create-shop-integration_response	object
id	int32
name	string
cartUrl	string
created	date-time
apiKey	string

Response

xxxxxxxxxx
 
{ "id": 1, "name": "Name of the shop", "cartUrl": "https://redirect.my.customer/to-this-cart-url", "created": "2025-04-05 11:53:52", "apiKey": "ftCympnHkbYoqXXOguI84Gj3UnmKji0ZD62DKV53"}
Copy

Pricing

POST

/price/import

Update pricing data

Auth

Request Body

array	array[object]
sku	string	Your SKU used for the product configuration. If this is omitted, "offeringid" will have to be provided.
offeringid	integer	The FastEditor id for the product configuration. If this is omitted, "sku" will have to be provided.
listPrice	integer	The normal catalogue price of the product. Price should be provided in cents.
listPrice_addOn	number	For products that can be extended with addOns. For instance, for photobooks this would be the price of an extra page. Pricing in cents.
discountPrice	integer	The discounted base price of the product. If provided, FastEditor will show the from...for pricing to the user.
discountPrice_addOn	number	The discounted price for the addOn.
currency	string	The currency for which you are setting the price

POST /price/import

xxxxxxxxxx
 
curl --request POST \ --url 'https://api.editor.staging.fasteditor.com/api/price/import' \ --header 'X-Api-Key: {X-Api-Key}' \ --data '[  {    "sku": "TUMBLER",    "listPrice": 1299,    "discountPrice": 999  },  {    "sku": "TUMBLER2",    "listPrice": 1299,    "discountPrice": 999  }]'
Copy

Responses

201

Created

array	array[object]
sku	string	Your SKU used for the product configuration. If this is omitted, "offeringid" will have to be provided.
offeringid	integer	The FastEditor id for the product configuration. If this is omitted, "sku" will have to be provided.
listPrice	integer	The normal catalogue price of the product. Price should be provided in cents.
listPrice_addOn	number	For products that can be extended with addOns. For instance, for photobooks this would be the price of an extra page. Pricing in cents.
discountPrice	integer	The discounted base price of the product. If provided, FastEditor will show the from...for pricing to the user.
discountPrice_addOn	number	The discounted price for the addOn.
currency	string	The currency for which you are setting the price

Response

xxxxxxxxxx
 
[ {  "sku": "TUMBLER",  "listPrice": 1299,  "discountPrice": 999 }, {  "sku": "TUMBLER2",  "listPrice": 1299,  "discountPrice": 999 }]
Copy

Editor Label API Reference 1.0.0GNU GPLv3

Authentication

Shopping Cart Item

Delete Shoppingcartitem

Partner-user

Update user Id

Delete User

Get User's Products

Project

Delete Project

Shop Integration

Read shop integrations

Create a Shop

Read a shop integration

Update a shop integration

Rotate Shop API key

Pricing

Update pricing data

Editor Label API Reference 1.0.0 GNU GPLv3