MENU navbar-image

Introduction

This documentation aims to provide all the information you need to work with our API.

<aside>As you scroll, you'll see code examples for working with the API in different programming languages in the dark area to the right (or as part of the content on mobile).
You can switch the language used with the tabs at the top right (or from the nav menu at the top left on mobile).</aside>

Authenticating requests

This API is not authenticated.

Address

Get list of address by customer

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/addresses" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/addresses"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/addresses

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Create new address for customer

requires authentication

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/addresses" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"John Doe\",
    \"email\": \"john.doe@example.com\",
    \"phone\": \"0123456789\",
    \"country\": \"United States or US\",
    \"state\": \"California\",
    \"city\": \"Los Angeles\",
    \"address\": \"123 Main St\",
    \"is_default\": true,
    \"zip_code\": \"90001\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/addresses"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "0123456789",
    "country": "United States or US",
    "state": "California",
    "city": "Los Angeles",
    "address": "123 Main St",
    "is_default": true,
    "zip_code": "90001"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "id": 1,
        "name": "John Doe",
        "phone": "0123456789",
        "email": "john.doe@example.com",
        "country": "United States",
        "state": "California",
        "city": "Los Angeles",
        "address": "123 Main St",
        "zip_code": "90001",
        "is_default": true
    },
    "message": null
}

Request      

POST api/v1/ecommerce/addresses

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

name   string     

The name of the address owner. Example: John Doe

email   string     

The email address. Example: john.doe@example.com

phone   string     

The phone number. Example: 0123456789

country   string  optional    

The country name or country code. Example: United States or US

state   string  optional    

The state/province name. Example: California

city   string  optional    

The city name. Example: Los Angeles

address   string  optional    

The street address. Example: 123 Main St

is_default   boolean  optional    

Set as default address. Example: true

zip_code   string  optional    

The postal/zip code. Example: 90001

Update an address

requires authentication

Example request:
curl --request PUT \
    "https://demo.larashop.su/api/v1/ecommerce/addresses/1" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"John Doe\",
    \"email\": \"john.doe@example.com\",
    \"phone\": \"0123456789\",
    \"country\": \"United States or US\",
    \"state\": \"California\",
    \"city\": \"Los Angeles\",
    \"address\": \"123 Main St\",
    \"is_default\": true,
    \"zip_code\": \"90001\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/addresses/1"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "0123456789",
    "country": "United States or US",
    "state": "California",
    "city": "Los Angeles",
    "address": "123 Main St",
    "is_default": true,
    "zip_code": "90001"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "id": 1,
        "name": "John Doe",
        "phone": "0123456789",
        "email": "john.doe@example.com",
        "country": "United States",
        "state": "California",
        "city": "Los Angeles",
        "address": "123 Main St",
        "zip_code": "90001",
        "is_default": true
    },
    "message": null
}

Request      

PUT api/v1/ecommerce/addresses/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   integer     

The ID of the address. Example: 1

Body Parameters

name   string     

The name of the address owner. Example: John Doe

email   string     

The email address. Example: john.doe@example.com

phone   string     

The phone number. Example: 0123456789

country   string  optional    

The country name or country code. Example: United States or US

state   string     

The state/province name. Example: California

city   string     

The city name. Example: Los Angeles

address   string     

The street address. Example: 123 Main St

is_default   boolean  optional    

Set as default address. Example: true

zip_code   string  optional    

The postal/zip code. Example: 90001

Delete an address

requires authentication

Example request:
curl --request DELETE \
    "https://demo.larashop.su/api/v1/ecommerce/addresses/1" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/addresses/1"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": null,
    "message": "Address deleted successfully"
}

Request      

DELETE api/v1/ecommerce/addresses/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   integer     

The ID of the address. Example: 1

Get list of available countries

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/countries" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/countries"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": [
        {
            "name": "Vietnam",
            "code": "VN"
        }
    ],
    "message": null
}

Request      

GET api/v1/ecommerce/countries

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Ads

Get ads

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ads?keys[]=homepage-banner&keys[]=sidebar-banner" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"keys\": [
        \"homepage-banner\",
        \"sidebar-banner\"
    ]
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ads"
);

const params = {
    "keys[0]": "homepage-banner",
    "keys[1]": "sidebar-banner",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "keys": [
        "homepage-banner",
        "sidebar-banner"
    ]
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ads

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

keys   string[]  optional    

Array of ad keys to filter by.

Body Parameters

keys   string[]  optional    

Array of ad keys to filter by.

Authentication

Register

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/register" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"first_name\": \"John\",
    \"last_name\": \"Smith\",
    \"name\": \"architecto\",
    \"email\": \"gbailey@example.net\",
    \"password\": \"|]|{+-\",
    \"phone\": \"architecto\",
    \"password_confirmation\": \"architecto\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/register"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "first_name": "John",
    "last_name": "Smith",
    "name": "architecto",
    "email": "gbailey@example.net",
    "password": "|]|{+-",
    "phone": "architecto",
    "password_confirmation": "architecto"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": null,
    "message": "Registered successfully! We emailed you to verify your account!"
}

Example response (422):


{
    "message": "The given data was invalid.",
    "errors": {
        "name": [
            "The name field is required."
        ],
        "email": [
            "The email field is required."
        ],
        "password": [
            "The password field is required."
        ]
    }
}

Request      

POST api/v1/register

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

first_name   string  optional    

The first name of the user. This field is required when name is not present. Количество символов в поле value не может превышать 120. Количество символов в поле value должно быть не меньше 2. Example: John

last_name   string  optional    

The last name of the user. This field is required when name is not present. Количество символов в поле value не может превышать 120. Количество символов в поле value должно быть не меньше 2. Example: Smith

name   string     

The name of the user. Example: architecto

email   string     

The email of the user. Example: gbailey@example.net

password   string     

The password of user to create. Example: |]|{+-

phone   string     

The phone of the user. Example: architecto

password_confirmation   string     

The password confirmation. Example: architecto

Login

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/login" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"gbailey@example.net\",
    \"password\": \"|]|{+-\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/login"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "email": "gbailey@example.net",
    "password": "|]|{+-"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "token": "1|aF5s7p3xxx1lVL8hkSrPN72m4wPVpTvTs..."
    },
    "message": null
}

Request      

POST api/v1/login

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

email   string     

The email of the user. Example: gbailey@example.net

password   string     

The password of user to create. Example: |]|{+-

Check email existing or not

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/email/check" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"gbailey@example.net\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/email/check"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "email": "gbailey@example.net"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "exists": true
    },
    "message": null
}

Request      

POST api/v1/email/check

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

email   string     

The email of the user. Example: gbailey@example.net

Forgot password

Send a reset link to the given user.

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/password/forgot" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"gbailey@example.net\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/password/forgot"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "email": "gbailey@example.net"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/password/forgot

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

email   string     

The email of the user. Example: gbailey@example.net

Resend email verification

Resend the email verification notification.

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/resend-verify-account-email" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"gbailey@example.net\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/resend-verify-account-email"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "email": "gbailey@example.net"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/resend-verify-account-email

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

email   string     

The email of the user. Example: gbailey@example.net

Resend email verification

Resend the email verification notification.

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/resend-email-verification" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"gbailey@example.net\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/resend-email-verification"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "email": "gbailey@example.net"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/resend-email-verification

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

email   string     

The email of the user. Example: gbailey@example.net

Logout

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/logout" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/logout"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/logout

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Blog

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/search" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"q\": \"architecto\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/search"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "q": "architecto"
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "items": [
            {
                "id": 1,
                "title": "Sample Post",
                "slug": "sample-post",
                "excerpt": "This is a sample post excerpt"
            }
        ],
        "query": "sample",
        "count": 1
    }
}

Example response (400):


{
    "error": true,
    "message": "No search result"
}

List posts

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/posts?per_page=16&page=16" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/posts"
);

const params = {
    "per_page": "16",
    "page": "16",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": [
        {
            "id": 1,
            "title": "Sample Post",
            "slug": "sample-post",
            "excerpt": "This is a sample post excerpt",
            "content": "Full post content here...",
            "published_at": "2023-01-01T00:00:00.000000Z",
            "author": {
                "id": 1,
                "name": "John Doe"
            },
            "categories": [],
            "tags": []
        }
    ],
    "message": null
}

Request      

GET api/v1/posts

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

per_page   integer  optional    

The number of items to return per page (default: 10). Example: 16

page   integer  optional    

The page number to retrieve (default: 1). Example: 16

List categories

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/categories?per_page=16&page=16" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/categories"
);

const params = {
    "per_page": "16",
    "page": "16",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": [
        {
            "id": 1,
            "name": "Technology",
            "slug": "technology",
            "description": "Latest tech news and updates",
            "created_at": "2023-01-01T00:00:00.000000Z"
        }
    ],
    "message": null
}

Request      

GET api/v1/categories

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

per_page   integer  optional    

The number of items to return per page (default: 10). Example: 16

page   integer  optional    

The page number to retrieve (default: 1). Example: 16

List tags

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/tags?per_page=16&page=16" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/tags"
);

const params = {
    "per_page": "16",
    "page": "16",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": [
        {
            "id": 1,
            "name": "Laravel",
            "slug": "laravel",
            "description": "PHP Framework for web development",
            "created_at": "2023-01-01T00:00:00.000000Z"
        }
    ],
    "message": null
}

Request      

GET api/v1/tags

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

per_page   integer  optional    

The number of items to return per page (default: 10). Example: 16

page   integer  optional    

The page number to retrieve (default: 1). Example: 16

Filters posts

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/posts/filters?page=16&per_page=16&search=architecto&after=architecto&author=architecto&author_exclude=architecto&before=architecto&exclude=architecto&include=architecto&order=architecto&order_by=architecto&categories=architecto&categories_exclude=architecto&tags=architecto&tags_exclude=architecto&featured=architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/posts/filters"
);

const params = {
    "page": "16",
    "per_page": "16",
    "search": "architecto",
    "after": "architecto",
    "author": "architecto",
    "author_exclude": "architecto",
    "before": "architecto",
    "exclude": "architecto",
    "include": "architecto",
    "order": "architecto",
    "order_by": "architecto",
    "categories": "architecto",
    "categories_exclude": "architecto",
    "tags": "architecto",
    "tags_exclude": "architecto",
    "featured": "architecto",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/posts/filters

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

page   integer  optional    

Current page of the collection. Default: 1 Example: 16

per_page   integer  optional    

Maximum number of items to be returned in result set.Default: 10 Example: 16

search   string  optional    

Limit results to those matching a string. Example: architecto

after   string  optional    

Limit response to posts published after a given ISO8601 compliant date. Example: architecto

author   string  optional    

Limit result set to posts assigned to specific authors. Example: architecto

author_exclude   string  optional    

Ensure result set excludes posts assigned to specific authors. Example: architecto

before   string  optional    

Limit response to posts published before a given ISO8601 compliant date. Example: architecto

exclude   string  optional    

Ensure result set excludes specific IDs. Example: architecto

include   string  optional    

Limit result set to specific IDs. Example: architecto

order   string  optional    

Order sort attribute ascending or descending. Default: desc .One of: asc, desc Example: architecto

order_by   string  optional    

Sort collection by object attribute. Default: updated_at. One of: author, created_at, updated_at, id, slug, title Example: architecto

categories   string  optional    

Limit result set to all items that have the specified term assigned in the categories taxonomy. Example: architecto

categories_exclude   string  optional    

Limit result set to all items except those that have the specified term assigned in the categories taxonomy. Example: architecto

tags   string  optional    

Limit result set to all items that have the specified term assigned in the tags taxonomy. Example: architecto

tags_exclude   string  optional    

Limit result set to all items except those that have the specified term assigned in the tags taxonomy. Example: architecto

featured   string  optional    

Limit result set to items that are sticky. Example: architecto

Get post by slug

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/posts/architecto?slug=architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/posts/architecto"
);

const params = {
    "slug": "architecto",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/posts/{slug}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

slug   string     

The slug of the post. Example: architecto

Query Parameters

slug   string  optional    

Find by slug of post. Example: architecto

Filters categories

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/categories/filters?page=16&per_page=16&search=architecto&order=architecto&order_by=architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/categories/filters"
);

const params = {
    "page": "16",
    "per_page": "16",
    "search": "architecto",
    "order": "architecto",
    "order_by": "architecto",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": [
        {
            "id": 1,
            "name": "Technology",
            "slug": "technology",
            "description": "Latest tech news and updates"
        }
    ],
    "message": null
}

Request      

GET api/v1/categories/filters

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

page   integer  optional    

Current page of the collection (default: 1). Example: 16

per_page   integer  optional    

Maximum number of items to be returned (default: 10). Example: 16

search   string  optional    

Limit results to those matching a string. Example: architecto

order   string  optional    

Order sort attribute ascending or descending (default: desc). One of: asc, desc. Example: architecto

order_by   string  optional    

Sort collection by object attribute (default: created_at). One of: created_at, updated_at, id, name. Example: architecto

Get category by slug

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/categories/architecto?slug=architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/categories/architecto"
);

const params = {
    "slug": "architecto",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/categories/{slug}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

slug   string     

The slug of the category. Example: architecto

Query Parameters

slug   string  optional    

Find by slug of category. Example: architecto

Brands

Get list of brands

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/brands?brands=" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"is_featured\": true
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/brands"
);

const params = {
    "brands": "",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "is_featured": true
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/brands

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

brands   string[]  optional    

List of brand IDs if you need filter by brands.

page   integer  optional    

Page number. Default: 1.

per_page   integer  optional    

Number of items per page. Default: 16.

Body Parameters

brands   string[]  optional    

The id of an existing record in the ec_product_brands table.

is_featured   boolean  optional    

Filter by featured status. Example: true

Get brand details by slug

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/brands/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/brands/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/brands/{slug}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

slug   string     

The slug of the brand. Example: architecto

Get products by brand

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/brands/6/products" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/brands/6/products"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/brands/{id}/products

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   integer     

The ID of the brand. Example: 6

Cart

Add product to cart

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/cart" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1,
    \"qty\": 1
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/cart"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1,
    "qty": 1
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/cart

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

product_id   integer     

ID of the product. Example: 1

qty   integer     

Quantity of the product. Default: 1. Example: 1

Add product to cart

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/cart/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1,
    \"qty\": 1
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/cart/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1,
    "qty": 1
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/cart/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the cart. Example: architecto

Body Parameters

product_id   integer     

ID of the product. Example: 1

qty   integer     

Quantity of the product. Default: 1. Example: 1

Update quantity of a product in cart

Example request:
curl --request PUT \
    "https://demo.larashop.su/api/v1/ecommerce/cart/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1,
    \"qty\": 1
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/cart/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1,
    "qty": 1
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

PUT api/v1/ecommerce/cart/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the cart. Example: architecto

Body Parameters

product_id   integer     

ID of the product. Example: 1

qty   integer     

Quantity of the product. Example: 1

Remove a cart item by its ID.

Example request:
curl --request DELETE \
    "https://demo.larashop.su/api/v1/ecommerce/cart/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/cart/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1
};

fetch(url, {
    method: "DELETE",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

DELETE api/v1/ecommerce/cart/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the cart. Example: architecto

Body Parameters

product_id   string     

The ID of the product to remove from the cart. The id of an existing record in the ec_products table. Example: 1

Get a cart item by id.

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/cart/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"customer_id\": 1,
    \"id\": \"e70c6c88dae8344b03e39bb147eba66a\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/cart/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "customer_id": 1,
    "id": "e70c6c88dae8344b03e39bb147eba66a"
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/cart/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the cart. Example: architecto

Body Parameters

customer_id   integer  optional    

is ID of the customer. Example: 1

id   string     

ID of the cart item. Example: e70c6c88dae8344b03e39bb147eba66a

Refresh cart items

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/cart/refresh" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"products\": [
        \"architecto\"
    ]
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/cart/refresh"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "products": [
        "architecto"
    ]
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/cart/refresh

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

products   string[]     

List of products with product_id and quantity.
product_id   integer     

The ID of the product. The id of an existing record in the ec_products table. Example: 1

quantity   integer     

The quantity of the product. Значение поля value должно быть не меньше 1. Example: 2

*   object  optional    
product_id   integer     

ID of the product. Example: 1

quantity   integer     

Quantity of the product. Example: 1

Calculate tax for products in cart

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/checkout/taxes/calculate" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"products\": [
        \"architecto\"
    ],
    \"country\": \"US\",
    \"state\": \"CA\",
    \"city\": \"Los Angeles\",
    \"zip_code\": \"90001\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/checkout/taxes/calculate"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "products": [
        "architecto"
    ],
    "country": "US",
    "state": "CA",
    "city": "Los Angeles",
    "zip_code": "90001"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "items": [
        {
            "product_id": 1,
            "price": 100,
            "price_formatted": "$100.00",
            "quantity": 2,
            "tax_rate": 10,
            "tax_amount": 20,
            "tax_amount_formatted": "$20.00",
            "subtotal": 200,
            "subtotal_formatted": "$200.00",
            "total": 220,
            "total_formatted": "$220.00"
        }
    ],
    "totals": {
        "sub_total": 200,
        "sub_total_formatted": "$200.00",
        "tax_amount": 20,
        "tax_amount_formatted": "$20.00",
        "total": 220,
        "total_formatted": "$220.00"
    }
}

Request      

POST api/v1/ecommerce/checkout/taxes/calculate

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

products   string[]     

List of products with id and quantity.
id   string     

The ID of the product. The id of an existing record in the ec_products table. Example: 1

quantity   integer     

The quantity of the product. Значение поля value должно быть не меньше 1. Example: 2

*   object  optional    
id   integer     

Product ID. Example: 1

quantity   integer     

Product quantity. Example: 2

country   string  optional    

Country code. Example: US

state   string  optional    

State code. Example: CA

city   string  optional    

City name. Example: Los Angeles

zip_code   string  optional    

ZIP code. Example: 90001

Checkout

Process Checkout Process the checkout for a specific cart ID. This endpoint restores the cart, generates an order token, and redirects the user to the checkout page.

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/checkout/cart/12345" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/checkout/cart/12345"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (302):


{}

Example response (401):


{
    "message": "Unauthenticated."
}

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
set-cookie: botble_session=eyJpdiI6IlZjMlkxMy81NVphR3hPU25jMWdnTHc9PSIsInZhbHVlIjoiNjFPQmxXdVdZL25vNkVjSExFb0VSMUxaclF0S1pEV1I5L24xYjlIbmtVWU9OekdCM0FvQUxpYms1WFVqOXdmQXduVHVpbTZaRUFreHExN2hXNlVPcmxMcVFodkhFempadGdFb0dUNFp4bnF2ZFk0RGRjTHgxUzcwZkEyV1RQM3UiLCJtYWMiOiI3MGY1MDZiM2YwNmQ5NmVhM2RiZTAxN2QzZTc1NmY0ODgxZTc4OWZjMGU3M2EyZjA0MmViMGUxNDZiYWQ2NWQ5IiwidGFnIjoiIn0%3D; expires=Wed, 25 Feb 2026 16:11:49 GMT; Max-Age=7200; path=/; httponly; samesite=lax
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Example response (404):


{
    "message": "Cart not found."
}

Request      

GET api/v1/ecommerce/checkout/cart/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the cart to process. Example: 12345

Compare

Add product to compare

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/compare" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/compare"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/compare

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

product_id   integer     

ID of the product. Example: 1

Add product to compare

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/compare/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/compare/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/compare/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the compare. Example: architecto

Body Parameters

product_id   integer     

ID of the product. Example: 1

Remove a product from compare list

Example request:
curl --request DELETE \
    "https://demo.larashop.su/api/v1/ecommerce/compare/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/compare/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1
};

fetch(url, {
    method: "DELETE",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

DELETE api/v1/ecommerce/compare/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the compare. Example: architecto

Body Parameters

product_id   string     

The ID of the product to remove from the compare list. The id of an existing record in the ec_products table. Example: 1

Get compare items

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/compare/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"id\": \"e70c6c88dae8344b03e39bb147eba66a\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/compare/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "id": "e70c6c88dae8344b03e39bb147eba66a"
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/compare/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the compare. Example: architecto

Body Parameters

id   string     

ID of the compare list. Example: e70c6c88dae8344b03e39bb147eba66a

Coupons

Get all available coupons

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/coupons?coupon_ids=1%2C2%2C3" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/coupons"
);

const params = {
    "coupon_ids": "1,2,3",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/coupons

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

coupon_ids   string  optional    

Optional comma-separated list of coupon IDs to filter by. Example: 1,2,3

Apply coupon code

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/coupon/apply" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"coupon_code\": \"DISCOUNT20\",
    \"cart_id\": \"e70c6c88dae8344b03e39bb147eba66a\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/coupon/apply"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "coupon_code": "DISCOUNT20",
    "cart_id": "e70c6c88dae8344b03e39bb147eba66a"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/coupon/apply

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

coupon_code   string     

The coupon code. Example: DISCOUNT20

cart_id   string     

ID of the cart to apply coupon to. Example: e70c6c88dae8344b03e39bb147eba66a

Remove coupon code

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/coupon/remove" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"cart_id\": \"e70c6c88dae8344b03e39bb147eba66a\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/coupon/remove"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "cart_id": "e70c6c88dae8344b03e39bb147eba66a"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/coupon/remove

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

cart_id   string  optional    

ID of the cart to remove coupon from. Example: e70c6c88dae8344b03e39bb147eba66a

Currencies

Get list of available currencies

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/currencies" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/currencies"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": [
        {
            "id": 1,
            "title": "USD",
            "symbol": "$",
            "is_prefix_symbol": true,
            "decimals": 2,
            "order": 0,
            "is_default": true,
            "exchange_rate": 1
        },
        {
            "id": 2,
            "title": "EUR",
            "symbol": "€",
            "is_prefix_symbol": false,
            "decimals": 2,
            "order": 1,
            "is_default": false,
            "exchange_rate": 0.91
        }
    ],
    "message": null
}

Request      

GET api/v1/ecommerce/currencies

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Get current currency

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/currencies/current" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/currencies/current"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "id": 1,
        "title": "USD",
        "symbol": "$",
        "is_prefix_symbol": true,
        "decimals": 2,
        "order": 0,
        "is_default": true,
        "exchange_rate": 1
    },
    "message": null
}

Request      

GET api/v1/ecommerce/currencies/current

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Device Tokens

Register or update device token

Register a new device token or update an existing one for push notifications.

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/device-tokens" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"token\": \"architecto\",
    \"platform\": \"architecto\",
    \"app_version\": \"architecto\",
    \"device_id\": \"architecto\",
    \"user_type\": \"architecto\",
    \"user_id\": 16
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/device-tokens"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "token": "architecto",
    "platform": "architecto",
    "app_version": "architecto",
    "device_id": "architecto",
    "user_type": "architecto",
    "user_id": 16
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/device-tokens

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

token   string     

The FCM device token. Example: architecto

platform   string  optional    

The device platform (android, ios). Example: architecto

app_version   string  optional    

The app version. Example: architecto

device_id   string  optional    

The unique device identifier. Example: architecto

user_type   string  optional    

The user type (customer, admin). Example: architecto

user_id   integer  optional    

The user ID. Example: 16

Get user's device tokens

Retrieve all device tokens for the authenticated user.

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/device-tokens" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/device-tokens"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/device-tokens

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Update device token

Update an existing device token.

Example request:
curl --request PUT \
    "https://demo.larashop.su/api/v1/device-tokens/564" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"platform\": \"architecto\",
    \"app_version\": \"architecto\",
    \"device_id\": \"architecto\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/device-tokens/564"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "platform": "architecto",
    "app_version": "architecto",
    "device_id": "architecto"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

PUT api/v1/device-tokens/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the device token. Example: 564

Body Parameters

platform   string  optional    

The device platform (android, ios). Example: architecto

app_version   string  optional    

The app version. Example: architecto

device_id   string  optional    

The unique device identifier. Example: architecto

Delete device token by token value

Delete a device token using the token value.

Example request:
curl --request DELETE \
    "https://demo.larashop.su/api/v1/device-tokens/by-token" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"token\": \"architecto\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/device-tokens/by-token"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "token": "architecto"
};

fetch(url, {
    method: "DELETE",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

DELETE api/v1/device-tokens/by-token

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

token   string     

The FCM device token to delete. Example: architecto

Delete device token

Delete a device token to stop receiving push notifications.

Example request:
curl --request DELETE \
    "https://demo.larashop.su/api/v1/device-tokens/564" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/device-tokens/564"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Request      

DELETE api/v1/device-tokens/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the device token. Example: 564

Deactivate device token

Deactivate a device token without deleting it.

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/device-tokens/564/deactivate" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/device-tokens/564/deactivate"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/v1/device-tokens/{id}/deactivate

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the device token. Example: 564

Downloads

Get list of digital products available for download

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/downloads" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/downloads"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/downloads

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Download a digital product

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/downloads/564" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/downloads/564"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/downloads/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the download. Example: 564

Endpoints

Download a file using a token

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/download/architecto/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/download/architecto/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/download/{token}/{order_id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

token   string     

Example: architecto

order_id   string     

The ID of the order. Example: architecto

Download a proof file using a token

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/orders/download-proof/architecto/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/orders/download-proof/architecto/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/orders/download-proof/{token}/{order_id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

token   string     

Example: architecto

order_id   string     

The ID of the order. Example: architecto

Filters

Get filter data for products

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/filters" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/filters"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/filters

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

category   integer  optional    

Category ID to get filter data for a specific category.

Flash Sale

Get flash sales

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/flash-sales?keys=&thumbnail_size=architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"keys\": null
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/flash-sales"
);

const params = {
    "keys": "",
    "thumbnail_size": "architecto",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "keys": null
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/flash-sales

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

keys   string[]  optional    

Array of flash sale keys to filter by.

thumbnail_size   string  optional    

Size of product thumbnail images. Value: thumb, small, medium, large. Default: thumb Example: architecto

Body Parameters

keys   string[]  optional    

Array of flash sale keys to filter by.

Notifications

Get user notifications

Retrieve notifications for the authenticated user.

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/notifications?page=1&per_page=20&unread_only=&type=general" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/notifications"
);

const params = {
    "page": "1",
    "per_page": "20",
    "unread_only": "0",
    "type": "general",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/notifications

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

page   integer  optional    

Page number for pagination. Example: 1

per_page   integer  optional    

Number of notifications per page (max 50). Example: 20

unread_only   boolean  optional    

Filter to show only unread notifications. Example: false

type   string  optional    

Filter by notification type. Example: general

Get notification statistics

Get notification statistics for the authenticated user.

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/notifications/stats" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/notifications/stats"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/notifications/stats

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Mark all notifications as read

Mark all notifications as read for the authenticated user.

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/notifications/mark-all-read" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/notifications/mark-all-read"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/v1/notifications/mark-all-read

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Mark notification as read

Mark a specific notification as read for the authenticated user.

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/notifications/564/read" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/notifications/564/read"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/v1/notifications/{id}/read

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the notification. Example: 564

Mark notification as clicked

Mark a notification as clicked when user taps on it.

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/notifications/564/clicked" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/notifications/564/clicked"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/v1/notifications/{id}/clicked

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the notification. Example: 564

Delete notification

Delete a notification from user's list.

Example request:
curl --request DELETE \
    "https://demo.larashop.su/api/v1/notifications/564" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/notifications/564"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Request      

DELETE api/v1/notifications/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the notification. Example: 564

Order Returns

Get list of order return requests for the current user

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/order-returns" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/order-returns"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/order-returns

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Get detail of an order return request

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/order-returns/564" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/order-returns/564"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/order-returns/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the order return. Example: 564

Submit a new order return request

requires authentication

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/order-returns" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"order_id\": 1,
    \"return_items\": [
        \"architecto\"
    ],
    \"reason\": \"DAMAGED_PRODUCT\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/order-returns"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "order_id": 1,
    "return_items": [
        "architecto"
    ],
    "reason": "DAMAGED_PRODUCT"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/order-returns

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

order_id   integer     

The ID of the order to return. Example: 1

return_items   string[]     

The items to return with order_item_id, is_return, and qty.
is_return   string  optional    

Whether this item should be returned. Example: true

order_item_id   number  optional    

The ID of the order item to return. This field is required when return_items.*.is_return or checked is present. The id of an existing record in the ec_order_product table. Example: 1

qty   number  optional    

The quantity to return. Значение поля value должно быть не меньше 1. Example: 2

*   object  optional    
order_item_id   integer     

The ID of the order item. Example: 1

is_return   boolean     

Whether to return this item. Example: true

qty   integer  optional    

The quantity to return (required if partial return is enabled). Example: 1

reason   string  optional    

The reason for returning this item (required if partial return is enabled). Example: DAMAGED_PRODUCT

reason   string     

The reason for the return. Example: DAMAGED_PRODUCT

Get order information for return request

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/orders/564/returns" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/orders/564/returns"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/orders/{order_id}/returns

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

order_id   string     

The ID of the order. Example: 564

Orders

APIs for order tracking

Get list of orders by customer

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/orders?status=completed&shipping_status=delivered&payment_status=completed&per_page=10" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/orders"
);

const params = {
    "status": "completed",
    "shipping_status": "delivered",
    "payment_status": "completed",
    "per_page": "10",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/orders

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

status   string  optional    

Filter orders by status (pending, processing, completed, canceled). Example: completed

shipping_status   string  optional    

Filter orders by shipping status (not_shipped, delivering, delivered, canceled). Example: delivered

payment_status   string  optional    

Filter orders by payment status (pending, completed, refunding, refunded, canceled). Example: completed

per_page   integer  optional    

Number of orders per page. Example: 10

Get order detail

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/orders/564" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/orders/564"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/orders/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the order. Example: 564

Cancel an order

requires authentication

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/orders/564/cancel" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"cancellation_reason\": \"OTHER\",
    \"cancellation_reason_description\": \"I found a better deal elsewhere\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/orders/564/cancel"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "cancellation_reason": "OTHER",
    "cancellation_reason_description": "I found a better deal elsewhere"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/orders/{id}/cancel

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the order. Example: 564

Body Parameters

cancellation_reason   string     

The reason for cancellation. Example: OTHER

cancellation_reason_description   string  optional    

The description of the cancellation reason (required if cancellation_reason is OTHER). Example: I found a better deal elsewhere

Print an order invoice

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/orders/564/invoice?type=download&format=architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/orders/564/invoice"
);

const params = {
    "type": "download",
    "format": "architecto",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/orders/{id}/invoice

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the order. Example: 564

Query Parameters

type   string  optional    

Type of response (print or download). Example: download

format   string  optional    

Response format (url or pdf). Use 'pdf' for direct PDF content, 'url' for URL response. Default: url Example: architecto

Upload payment proof for an order

requires authentication

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/orders/564/upload-proof" \
    --header "Content-Type: multipart/form-data" \
    --header "Accept: application/json" \
    --form "file=@/tmp/phpu8raen8gvcrqeXTkPZe" 
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/orders/564/upload-proof"
);

const headers = {
    "Content-Type": "multipart/form-data",
    "Accept": "application/json",
};

const body = new FormData();
body.append('file', document.querySelector('input[name="file"]').files[0]);

fetch(url, {
    method: "POST",
    headers,
    body,
}).then(response => response.json());

Request      

POST api/v1/ecommerce/orders/{id}/upload-proof

Headers

Content-Type        

Example: multipart/form-data

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the order. Example: 564

Body Parameters

file   file     

The payment proof file (jpeg, jpg, png, pdf, max 2MB). Example: /tmp/phpu8raen8gvcrqeXTkPZe

Download payment proof for an order

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/orders/564/download-proof" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/orders/564/download-proof"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/orders/{id}/download-proof

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the order. Example: 564

Confirm delivery of an order

requires authentication

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/orders/564/confirm-delivery" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/orders/564/confirm-delivery"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/v1/ecommerce/orders/{id}/confirm-delivery

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the order. Example: 564

Track an order

Track an order by order code and email/phone

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/orders/tracking" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"code\": \"ORD-12345\",
    \"email\": \"customer@example.com\",
    \"phone\": \"+1234567890\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/orders/tracking"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "code": "ORD-12345",
    "email": "customer@example.com",
    "phone": "+1234567890"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "message": "Order found successfully",
    "data": {
        "order": {
            "id": 1,
            "code": "ORD-12345",
            "status": "completed",
            "amount": 100,
            "shipping_amount": 10,
            "payment_fee": 5,
            "tax_amount": 5,
            "sub_total": 90,
            "discount_amount": 0,
            "payment_id": 1,
            "user_id": 1,
            "created_at": "2023-08-10T12:34:56.000000Z",
            "updated_at": "2023-08-10T12:34:56.000000Z",
            "address": {
                "id": 1,
                "name": "John Doe",
                "email": "customer@example.com",
                "phone": "+1234567890",
                "address": "123 Main St",
                "city": "New York",
                "state": "NY",
                "country": "US",
                "zip_code": "10001"
            },
            "products": [
                {
                    "id": 1,
                    "name": "Product 1",
                    "price": 90,
                    "qty": 1
                }
            ],
            "histories": [
                {
                    "id": 1,
                    "action": "create_order",
                    "description": "Order was created",
                    "created_at": "2023-08-10T12:34:56.000000Z"
                }
            ],
            "shipment": {
                "id": 1,
                "status": "delivered",
                "tracking_id": "SHIP-12345",
                "tracking_link": "https://example.com/tracking/SHIP-12345"
            },
            "payment": {
                "id": 1,
                "status": "completed",
                "payment_channel": "stripe",
                "amount": 100
            }
        }
    }
}

Example response (404):


{
    "error": true,
    "message": "Order not found",
    "code": 404
}

Request      

POST api/v1/ecommerce/orders/tracking

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

code   string     

The order code. Example: ORD-12345

email   string     

if phone not provided The email associated with the order. Example: customer@example.com

phone   string     

if email not provided The phone number associated with the order. Example: +1234567890

Page

List pages

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/pages?per_page=16&page=16" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/pages"
);

const params = {
    "per_page": "16",
    "page": "16",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": [
        {
            "id": 1,
            "title": "About Us",
            "slug": "about-us",
            "content": "This is the about us page content...",
            "published_at": "2023-01-01T00:00:00.000000Z"
        }
    ],
    "message": null
}

Request      

GET api/v1/pages

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

per_page   integer  optional    

The number of items to return per page (default: 10). Example: 16

page   integer  optional    

The page number to retrieve (default: 1). Example: 16

Get page by ID

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/pages/16" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/pages/16"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "id": 1,
        "title": "About Us",
        "slug": "about-us",
        "content": "This is the about us page content...",
        "published_at": "2023-01-01T00:00:00.000000Z"
    },
    "message": null
}

Example response (404):


{
    "error": true,
    "message": "Not found"
}

Request      

GET api/v1/pages/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   integer     

The ID of the page to retrieve. Example: 16

Product Categories

Get list of product categories

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/product-categories" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"is_featured\": true
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/product-categories"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "is_featured": true
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/product-categories

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

categories   string  optional    

nullable array List of category IDs if you need filter by categories, (e.g. [1,2,3]).

page   integer  optional    

Page number. Default: 1.

per_page   integer  optional    

Number of items per page. Default: 16.

Body Parameters

categories   string[]  optional    

The id of an existing record in the ec_product_categories table.

is_featured   boolean  optional    

Filter by featured status. Example: true

Get product category details by slug

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/product-categories/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/product-categories/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/product-categories/{slug}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

slug   string     

The slug of the product category. Example: architecto

Get products by category

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/product-categories/564/products" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/product-categories/564/products"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/product-categories/{id}/products

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the product category. Example: 564

Products

Get list of products

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/products?sort_by=architecto&price_ranges=%5B%7B%22from%22%3A10%2C%22to%22%3A20%7D%2C%7B%22from%22%3A30%2C%22to%22%3A40%7D%5D&attributes=%5B%7B%22id%22%3A1%2C%22value%22%3A1%7D%2C%7B%22id%22%3A2%2C%22value%22%3A2%7D%5D&thumbnail_size=architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/products"
);

const params = {
    "sort_by": "architecto",
    "price_ranges": "[{"from":10,"to":20},{"from":30,"to":40}]",
    "attributes": "[{"id":1,"value":1},{"id":2,"value":2}]",
    "thumbnail_size": "architecto",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/products

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

categories   string[]  optional    

Filter by category IDs.

brands   string[]  optional    

Filter by brand IDs.

collections   string[]  optional    

Filter by collection IDs.

q   string  optional    

Search term.

sort_by   string  optional    

Sort field. Value: default_sorting, date_asc, date_desc, price_asc, price_desc, name_asc, name_desc, rating_asc, rating_desc Example: architecto

page   integer  optional    

The current page.

per_page   integer  optional    

Number of items per page.

discounted_only   boolean  optional    

Filter by discounted only.

min_price   integer  optional    

Minimum price.

max_price   integer  optional    

Maximum price.

price_ranges   string  optional    

Price ranges as JSON string. Example: [{"from":10,"to":20},{"from":30,"to":40}]

attributes   string  optional    

Attributes as JSON string. Example: [{"id":1,"value":1},{"id":2,"value":2}]

thumbnail_size   string  optional    

Size of product thumbnail images. Value: thumb, small, medium, large. Default: thumb Example: architecto

Get product details by slug

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/products/architecto?thumbnail_size=architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/products/architecto"
);

const params = {
    "thumbnail_size": "architecto",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/products/{slug}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

slug   string     

The slug of the product. Example: architecto

Query Parameters

thumbnail_size   string  optional    

Size of product thumbnail images. Value: thumb, small, medium, large. Default: thumb Example: architecto

Get related products

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/products/architecto/related" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/products/architecto/related"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/products/{slug}/related

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

slug   string     

The slug of the product. Example: architecto

Get cross-sale products for a product

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/products/architecto/cross-sale" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/products/architecto/cross-sale"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/products/{slug}/cross-sale

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

slug   string     

The slug of the product. Example: architecto

Get product's reviews

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/products/architecto/reviews" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/products/architecto/reviews"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/products/{slug}/reviews

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

slug   string     

The slug of the product. Example: architecto

Get product variation by attributes

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/product-variation/564?attributes=" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"reference_product\": \"architecto\",
    \"attributes\": [
        \"architecto\"
    ]
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/product-variation/564"
);

const params = {
    "attributes": "",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "reference_product": "architecto",
    "attributes": [
        "architecto"
    ]
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/product-variation/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the product variation. Example: 564

Query Parameters

attributes   string[]  optional    

Array of attribute IDs.

reference_product   string  optional    

Reference product slug.

Body Parameters

reference_product   string  optional    

Example: architecto

attributes   string[]     

Profile

Get the user profile information.

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/me" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/me"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/me

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Update profile

requires authentication

Example request:
curl --request PUT \
    "https://demo.larashop.su/api/v1/me" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"first_name\": \"bngz\",
    \"last_name\": \"miyv\",
    \"name\": \"architecto\",
    \"phone\": \"architecto\",
    \"dob\": \"architecto\",
    \"gender\": \"architecto\",
    \"description\": \"Eius et animi quos velit et.\",
    \"email\": \"gbailey@example.net\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/me"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "first_name": "bngz",
    "last_name": "miyv",
    "name": "architecto",
    "phone": "architecto",
    "dob": "architecto",
    "gender": "architecto",
    "description": "Eius et animi quos velit et.",
    "email": "gbailey@example.net"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

PUT api/v1/me

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

first_name   string  optional    

This field is required when name is not present. Количество символов в поле value не может превышать 120. Количество символов в поле value должно быть не меньше 2. Example: bngz

last_name   string  optional    

This field is required when name is not present. Количество символов в поле value не может превышать 120. Количество символов в поле value должно быть не меньше 2. Example: miyv

name   string     

Name. Example: architecto

phone   string     

Phone. Example: architecto

dob   date  optional    

nullable Date of birth (format: Y-m-d). Example: architecto

gender   string  optional    

Gender (male, female, other). Example: architecto

description   string  optional    

Description Example: Eius et animi quos velit et.

email   string  optional    

Email. Example: gbailey@example.net

Update Avatar

requires authentication

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/update/avatar" \
    --header "Content-Type: multipart/form-data" \
    --header "Accept: application/json" \
    --form "avatar=@/tmp/phpbp9kj15sho4k5mDUZjA" 
const url = new URL(
    "https://demo.larashop.su/api/v1/update/avatar"
);

const headers = {
    "Content-Type": "multipart/form-data",
    "Accept": "application/json",
};

const body = new FormData();
body.append('avatar', document.querySelector('input[name="avatar"]').files[0]);

fetch(url, {
    method: "POST",
    headers,
    body,
}).then(response => response.json());

Request      

POST api/v1/update/avatar

Headers

Content-Type        

Example: multipart/form-data

Accept        

Example: application/json

Body Parameters

avatar   file     

Avatar file. Example: /tmp/phpbp9kj15sho4k5mDUZjA

Update password

requires authentication

Example request:
curl --request PUT \
    "https://demo.larashop.su/api/v1/update/password" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"password\": \"|]|{+-\",
    \"old_password\": \"architecto\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/update/password"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "password": "|]|{+-",
    "old_password": "architecto"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

PUT api/v1/update/password

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

password   string     

The new password of user. Example: |]|{+-

old_password   string     

The current password of user. Example: architecto

Get user settings

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/settings" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/settings"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/settings

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Update user settings

requires authentication

Example request:
curl --request PUT \
    "https://demo.larashop.su/api/v1/settings" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"biometric_enabled\": false,
    \"notification_enabled\": false,
    \"language\": \"architecto\",
    \"currency\": \"architecto\",
    \"theme\": \"architecto\",
    \"timezone\": \"Asia\\/Yekaterinburg\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/settings"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "biometric_enabled": false,
    "notification_enabled": false,
    "language": "architecto",
    "currency": "architecto",
    "theme": "architecto",
    "timezone": "Asia\/Yekaterinburg"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

PUT api/v1/settings

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

biometric_enabled   boolean  optional    

Enable/disable biometric authentication. Example: false

notification_enabled   boolean  optional    

Enable/disable notifications. Example: false

language   string  optional    

User's preferred language. Example: architecto

currency   string  optional    

User's preferred currency. Example: architecto

theme   string  optional    

User's preferred theme (light, dark, auto). Example: architecto

timezone   string  optional    

User's timezone. Example: Asia/Yekaterinburg

Reviews

Get list of reviews for the current user

requires authentication

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/reviews" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/reviews"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "error": true,
    "data": null,
    "message": "Unauthenticated."
}

Request      

GET api/v1/ecommerce/reviews

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Create a new review

requires authentication

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/reviews" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1,
    \"star\": 5,
    \"comment\": \"This is a great product! I highly recommend it.\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/reviews"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1,
    "star": 5,
    "comment": "This is a great product! I highly recommend it."
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/reviews

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

product_id   integer     

The ID of the product to review. Example: 1

star   integer     

The rating from 1 to 5 stars. Example: 5

comment   string     

The review comment. Example: This is a great product! I highly recommend it.

images   string[]  optional    

Array of images for the review (optional).

Delete a review

requires authentication

Example request:
curl --request DELETE \
    "https://demo.larashop.su/api/v1/ecommerce/reviews/564" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/reviews/564"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};


fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Request      

DELETE api/v1/ecommerce/reviews/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the review. Example: 564

Simple Slider

Get sliders

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/simple-sliders?keys[]=home-slider&keys[]=product-slider" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"keys\": [
        \"home-slider\",
        \"product-slider\"
    ]
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/simple-sliders"
);

const params = {
    "keys[0]": "home-slider",
    "keys[1]": "product-slider",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "keys": [
        "home-slider",
        "product-slider"
    ]
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/simple-sliders

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Query Parameters

keys   string[]  optional    

Array of slider keys to filter by.

Body Parameters

keys   string[]  optional    

Array of slider keys to filter by.

Social Login

Apple login

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/auth/apple" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"identityToken\": \"architecto\",
    \"guard\": \"architecto\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/auth/apple"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "identityToken": "architecto",
    "guard": "architecto"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "token": "1|abc123def456...",
        "user": {
            "id": 1,
            "name": "John Doe",
            "email": "john@example.com"
        }
    },
    "message": "Login successful"
}

Example response (400):


{
    "error": true,
    "message": "Invalid Apple token"
}

Example response (400):


{
    "error": true,
    "message": "Cannot login, no email or Apple ID provided!"
}

Request      

POST api/v1/auth/apple

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

identityToken   string     

The Apple identity token received from Apple Sign-In. Example: architecto

guard   string  optional    

optional The guard to use for authentication (default: web). Example: architecto

Google login

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/auth/google" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"identityToken\": \"architecto\",
    \"guard\": \"architecto\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/auth/google"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "identityToken": "architecto",
    "guard": "architecto"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "token": "1|abc123def456...",
        "user": {
            "id": 1,
            "name": "John Doe",
            "email": "john@example.com"
        }
    },
    "message": "Login successful"
}

Example response (400):


{
    "error": true,
    "message": "Invalid Google token"
}

Example response (400):


{
    "error": true,
    "message": "Google authentication is not properly configured"
}

Request      

POST api/v1/auth/google

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

identityToken   string     

The Google identity token received from Google Sign-In. Example: architecto

guard   string  optional    

optional The guard to use for authentication (default: web). Example: architecto

Facebook login

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/auth/facebook" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"accessToken\": \"architecto\",
    \"guard\": \"architecto\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/auth/facebook"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "accessToken": "architecto",
    "guard": "architecto"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "token": "1|abc123def456...",
        "user": {
            "id": 1,
            "name": "John Doe",
            "email": "john@example.com"
        }
    },
    "message": "Login successful"
}

Example response (400):


{
    "error": true,
    "message": "Invalid Facebook token"
}

Example response (400):


{
    "error": true,
    "message": "Facebook authentication is not properly configured"
}

Request      

POST api/v1/auth/facebook

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

accessToken   string     

The Facebook access token received from Facebook Login. Example: architecto

guard   string  optional    

optional The guard to use for authentication (default: web). Example: architecto

X (Twitter) login

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/auth/x" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"accessToken\": \"architecto\",
    \"guard\": \"architecto\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/auth/x"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "accessToken": "architecto",
    "guard": "architecto"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200):


{
    "error": false,
    "data": {
        "token": "1|abc123def456...",
        "user": {
            "id": 1,
            "name": "John Doe",
            "email": "john@example.com"
        }
    },
    "message": "Login successful"
}

Example response (400):


{
    "error": true,
    "message": "Invalid X (Twitter) token"
}

Example response (400):


{
    "error": true,
    "message": "X (Twitter) authentication is not properly configured"
}

Request      

POST api/v1/auth/x

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

accessToken   string     

The X (Twitter) access token received from X OAuth. Example: architecto

guard   string  optional    

optional The guard to use for authentication (default: web). Example: architecto

Wishlist

Add product to wishlist

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/wishlist" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/wishlist"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/wishlist

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

Body Parameters

product_id   integer     

ID of the product. Example: 1

Add product to wishlist

Example request:
curl --request POST \
    "https://demo.larashop.su/api/v1/ecommerce/wishlist/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/wishlist/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/v1/ecommerce/wishlist/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the wishlist. Example: architecto

Body Parameters

product_id   integer     

ID of the product. Example: 1

Remove a product from wishlist

Example request:
curl --request DELETE \
    "https://demo.larashop.su/api/v1/ecommerce/wishlist/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"product_id\": 1
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/wishlist/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "product_id": 1
};

fetch(url, {
    method: "DELETE",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

DELETE api/v1/ecommerce/wishlist/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the wishlist. Example: architecto

Body Parameters

product_id   string     

The ID of the product to remove from the wishlist. The id of an existing record in the ec_products table. Example: 1

Get wishlist items

Example request:
curl --request GET \
    --get "https://demo.larashop.su/api/v1/ecommerce/wishlist/architecto" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"id\": \"e70c6c88dae8344b03e39bb147eba66a\"
}"

const url = new URL(
    "https://demo.larashop.su/api/v1/ecommerce/wishlist/architecto"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "id": "e70c6c88dae8344b03e39bb147eba66a"
};

fetch(url, {
    method: "GET",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (401):

Show headers 
cache-control: no-cache, private
content-type: application/json
access-control-allow-origin: *
 

{
    "message": "Invalid or missing API key. Please provide a valid X-API-KEY header.",
    "error": "Unauthorized"
}

Request      

GET api/v1/ecommerce/wishlist/{id}

Headers

Content-Type        

Example: application/json

Accept        

Example: application/json

URL Parameters

id   string     

The ID of the wishlist. Example: architecto

Body Parameters

id   string     

ID of the wishlist. Example: e70c6c88dae8344b03e39bb147eba66a