API Documentation

The Faslet API gives you direct access to provide data, without having to go through third party services.

tip

Access to our APIs is available to customers on certain tiers. If you're in doubt, please reach out to your Faslet representative.

API Base Url

The base url for the API is

https://api.faslet.net/public/v1

If you'd like sandbox/staging environment to test against, please reach out to support, so we can create a test store.

Authorization

Include the custom header faslet-shopid set to your Faslet Shop ID. Your API token can be found in the Faslet Partner Portal. This needs to be included as a Bearer token with the authorization header.

Endpoints

All formats, request and response are JSON. Be sure to include the application/json content header.

Example headers:

"Content-Type" "application/json",
"faslet-shopid": "MY_SHOP_ID",
"authorization": "Bearer MY_API_TOKEN"

---

POST /returns

https://api.faslet.net/public/v1/returns

Request Body

An Array of Product Info

Product Info

Field	Required	Type	Description
orderId	YES	string	The identifier of the order
productId	YES	string	The identifier of the product. This should match the product id send to Faslet with the orders and the button
sku	YES	string	The variant SKU
returnDate	YES	string	ISO8601 Date Time
returnReason	YES	string	The return reason value as described below
returnReasonMessage	NO	string	A message for the return reason. This can be the message sent by the customer
externalId	NO	string	The ID of the return in your system

Example Request

[{
        "orderId": "1234",
        "productId": "1234",
        "sku": "1234",
        "returnReason": "1",
        "returnDate": "2022-02-05T18:40:00.000Z",
        "externalId": "o-123"
}, {
        "orderId": "3456",
        "productId": "3456",
        "sku": "3456",
        "returnReason": "3",
        "returnDate": "2022-09-05T18:40:00.000Z",
        "externalId": "o-345"
}]

Return reasons

Reason	Value
Too big	1
Too small	2
Product is damaged	3
Product isn’t as expected	4
Wrong article/ size	5
Color isn’t as expected	6
Quality isn’t as expected	7
Other reason	8
Multiple sizes ordered	9

Response

StatusCodes

Status	Description
202	The request was accepted.

Body

Field	Required	Type
errors	YES	Array of Return Error

Return Error

Field	Type	Description
message	string	The error message

Example Response

{
    "errors": [
        {
            "message": "returnDate is invalid for order 1234"
        }
    ]
}

---

POST /size-specs

https://api.faslet.net/public/v1/size-specs/MY_BRAND

Request Parameters

Field	Required	Type	Description
brand	YES	string	Then name of the brand for this size specification

Request Body

An Array of Product Size Descriptors

Product Size Descriptor

Field	Required	Type	Description
productName	YES	string	The name or title of the product.
productId	YES	string	The identifier of the product. This should match the product id send to Faslet with the orders and the button
gender	YES	string	The gender of the product. Must be male, female or unisex
productUrl	YES	string	The url of the product as found on the store
sizeChartSpecifications	YES	string	An array of size specifications

Size Chart Specification

Field	Required	Type	Description
sizeLabel	YES	string	The size label of the variant.
useDefaults	NO	boolean	Whether this variant should use default size charts as provided by Faslet.
waist	NO	number	The minimum measurement of the waist for this size label.
hips	NO	number	The minimum measurement of the hips for this size label.
chest	NO	number	The minimum measurement of the chest for this size label.
innerLeg	NO	number	The minimum measurement of the innerLeg for this size label.
length	NO	number	The minimum measurement of the length for this size label.
sleeve	NO	number	The minimum measurement of the sleeve for this size label.
thigh	NO	number	The minimum measurement of the thigh for this size label.
shoulder	NO	number	The minimum measurement of the shoulder for this size label.
waistStretched	NO	number	The maximum measurement of the waist for this size label.
hipsStretched	NO	number	The maximum measurement of the hips for this size label.
chestStretched	NO	number	The maximum measurement of the chest for this size label.

If you choose not to use defaults, please provide as much of this information as possible in order to get the most accurate size charts. Our algorithms will process these and optimize them based on how much information is given.

Example Request

[{
  "productName": "Jacket",
  "productId": "11",
  "gender": "male",
  "productUrl": "https://mywebstore.com/en/jacket.html",
  "sizeChartSpecifications": [{
    "useDefaults": false,
    "waist": 60,
    "waistStretched": 70,
    "hips": 50,
    "hipsStretched": 56,
    "chest": 65,
    "sizeLabel": "S"
  }, {
    "waist": 63,
    "hips": 53,
    "chest": 68,
    "sizeLabel": "M"
  }, {
    "waist": 68,
    "hips": 58,
    "chest": 73,
    "sizeLabel": "XL",
    "useDefaults": false
  }]
}]

Response

StatusCodes

Status	Description
201	New size specifications were created.
200	Existing size specifications were updated.

Body

Field	Required	Type
errors	NO	Array of Return Error. In the case of a 2xx response, with some (or all) size specifications skipped, a list of errors will be provided
error	NO	A Return Error. In the case of a 4xx response, a single error will be returned and nothing will be processed

Return Error

Field	Type	Description
message	string	The error message

Example Response

{
    "errors": [
        {
            "message": "[Item 42] No Product URL, ignoring"
        },
        {
            "message": "[Item 76] No Product ID, ignoring"
        }
    ]
}

info

Errors in individual Size Chart Specifications will not prevent everything from processing. The error will list the index of the descriptor that failed. These will return a 2xx status code and can be safely retried after fixing the errors.

Errors in the Product Size Descriptors will prevent processing and will return a 4xx status code.

---

Help

In case of any questions, please don’t hesitate to contact us on support@faslet.me